v1

latestOpenAPI 3.0.22026-07-26128245430.3 KB

Fiat Payout Configuration

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

Request body

Example request

{
  "fiat_payout_configuration": {
    "usd": {
      "wire": "customer"
    }
  }
}

Response

Successful fiat payout configuration update response

Example response

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