Update the fiat payout configuration for a customer

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.

PATCH /customers/{customerID}/fiat_payout_configuration

Update the fiat payout configuration for a customer

cURL

curl --request PATCH \
  --url https://api.bridge.xyz/v0/customers/{customerID}/fiat_payout_configuration \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "usd": {
    "wire": "customer"
  }
}
'

200

SuccessfulPatchFiatPayoutConfigurationResponse

{
  "fiat_payout_configuration": {
    "usd": {
      "wire": "customer",
      "ach": "bridge"
    },
    "eur": {
      "sepa": "bridge"
    },
    "brl": {
      "pix": "payment_provider"
    },
    "mxn": {
      "spei": "payment_provider"
    }
  }
}

Authorizations

Api-Key · string · header · required

Path Parameters

customerID · string · required

A UUID that uniquely identifies a resource

Required string length: 1 - 42

Pattern: [a-z0-9]*

Body

application/json

Fiat payout configuration to update

Input payload for updating a customer's fiat payout configuration

fiat_payout_configuration · object · 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.

Show child attributes

Example:

{
  "usd": { "wire": "developer", "ach": "bridge" },
  "eur": { "sepa": "bridge" },
  "brl": { "pix": "payment_provider" },
  "mxn": { "spei": "payment_provider" }
}

Response

200

application/json

Successful fiat payout configuration update response

fiat_payout_configuration · object · 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.

Show child attributes

Example:

{
  "usd": { "wire": "developer", "ach": "bridge" },
  "eur": { "sepa": "bridge" },
  "brl": { "pix": "payment_provider" },
  "mxn": { "spei": "payment_provider" }
}