---
title: "Update the fiat payout configuration for a customer"
method: PATCH
path: "/customers/{customerID}/fiat_payout_configuration"
tags: ["Fiat Payout Configuration"]
---

# Update the fiat payout configuration for a customer

`PATCH /customers/{customerID}/fiat_payout_configuration`

Update the fiat payout configuration for the given customer ID. This configuration determines which payout method (bridge, developer, payment_provider, or customer) is used for each currency and payment rail combination.

The configuration is a nested hash structure where:
- Top-level keys are currency codes (e.g., "usd", "eur", "brl", "mxn")
- Second-level keys are payment rail codes (e.g., "wire", "ach", "sepa", "pix", "spei")
- Values are payout names: `bridge`, `developer`, `payment_provider`, or `customer`

Currently, only the following values are supported for the payout method:
- usd.wire: `developer`, `customer`
- usd.ach: `bridge`
- eur.sepa: `bridge`
- brl.pix: `payment_provider`
- mxn.spei: `payment_provider`

Only the currency/payment rail combinations provided will be updated. Other existing configurations will remain unchanged.

## Request body

- PatchFiatPayoutConfigurationInput — Input payload for updating a customer's fiat payout configuration
  - `fiat_payout_configuration` FiatPayoutConfiguration, required — A nested hash structure representing the fiat payout configuration. The top-level keys are currency codes. Each currency maps to a hash where keys are payment rail codes and values are payout names.
    - `usd` object — Payment rail configuration for USD
      - `wire` 'developer' | 'customer' — The payout method to use for USD wire transfers
      - `ach` 'bridge' — The payout method to use for USD ACH transfers
    - `eur` object — Payment rail configuration for EUR
      - `sepa` 'bridge' — The payout method to use for EUR SEPA transfers
    - `brl` object — Payment rail configuration for BRL
      - `pix` 'payment_provider' — The payout method to use for BRL PIX transfers
    - `mxn` object — Payment rail configuration for MXN
      - `spei` 'payment_provider' — The payout method to use for MXN SPEI transfers

## Response `200`

Successful fiat payout configuration update response

- FiatPayoutConfigurationResponse
  - `fiat_payout_configuration` FiatPayoutConfiguration, required — A nested hash structure representing the fiat payout configuration. The top-level keys are currency codes. Each currency maps to a hash where keys are payment rail codes and values are payout names.
    - `usd` object — Payment rail configuration for USD
      - `wire` 'developer' | 'customer' — The payout method to use for USD wire transfers
      - `ach` 'bridge' — The payout method to use for USD ACH transfers
    - `eur` object — Payment rail configuration for EUR
      - `sepa` 'bridge' — The payout method to use for EUR SEPA transfers
    - `brl` object — Payment rail configuration for BRL
      - `pix` 'payment_provider' — The payout method to use for BRL PIX transfers
    - `mxn` object — Payment rail configuration for MXN
      - `spei` 'payment_provider' — The payout method to use for MXN SPEI transfers

## Other responses

- `400` — Request containing missing or invalid parameters.
- `401` — Missing or invalid API key
- `403` — Request not allowed. Contact your account manager to be enabled for this feature. Additional fees apply.
- `404` — No resource found
- `500` — Unexpected error. User may try and send the request again.

---

[API](https://skmtc.net/bridge/apis/bridge-api.md) · [All operations](https://skmtc.net/bridge/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bridge/bridge-api/revisions/570998bde3b5/schema)