# Update Payment Service Updates the configuration of an existing payment service. Endpoint: PUT /api/v3/payment_services/{id} Version: 3.1.0 Security: apiKeyAuth ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Path parameters: - `id` (integer, required) Payment service id ## Request fields (application/json): - `payment_service` (object, required) Required. Missing → 400 (when id is the configured service). - `payment_service.credentials` (object) Credential fields required by the selected provider, as key/value pairs. A credential the provider marks as not editable must be sent unchanged (or omitted); a different value → 422 ("This field cannot be edited."). - `payment_service.credentials.key` (string) Example: "value" - `payment_service.extra_options` (object) - `payment_service.extra_options.auto_add_payment_reference` (boolean) Example: true - `payment_service.extra_options.auto_add_payment_reference_estimates` (boolean) - `payment_service.extra_options.auto_send_invoice_from_estimate` (boolean) ## Response 200 fields (application/json): - `payment_service` (object) - `payment_service.id` (integer) Example: 1 - `payment_service.name` (string) Example: "euPago" - `payment_service.url` (string) Example: "https://eupago.pt" - `payment_service.logo` (string) An HTML `` tag, not a URL. Example: "euPago" - `payment_service.configured` (boolean) Example: true - `payment_service.credentials` (array) - `payment_service.credentials.key` (string) Example: "api_key" - `payment_service.credentials.value` (string) Example: "1234-5678-9123-4567" - `payment_service.credentials.type` (string) Example: "text" - `payment_service.credentials.editable` (boolean) Example: true - `payment_service.extra_options` (object) The account's payment options. An empty object {} unless this is the configured payment service. - `payment_service.extra_options.auto_add_payment_reference` (boolean) Example: true - `payment_service.extra_options.auto_add_payment_reference_estimates` (boolean) - `payment_service.extra_options.auto_send_invoice_from_estimate` (boolean) ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 422 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string) ## Response 500 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string) ## Response 400 fields