Going live

Fiat & auto-payouts

This page covers developer-relevant fiat payout APIs and automation controls exposed publicly.

Fiat capability endpoints

GET/v1/merchant/fiat/corridorsAvailable fiat corridors
POST/v1/merchant/fiat/institutionsInstitutions for corridor/currency
POST/v1/merchant/fiat/beneficiary/resolveResolve beneficiary details

Use these before rendering fiat payout forms so users only see valid corridor/currency/institution combinations.

Automatic fiat payout settings

GET/v1/merchant/auto-fiat-payout-settingsRead auto-fiat settings
PUT/v1/merchant/auto-fiat-payout-settingsUpdate auto-fiat settings
  • Enable/disable automatic fiat payout behavior per environment.
  • Configure destination and optional asset filters.
  • Pair with dashboard monitoring and payout failure alerts.

Manual versus automatic payouts

  • Manual: explicit POST /v1/payouts per transfer.
  • Automatic: enabled policy triggers payout flow as eligible funds arrive.

Scope and safety

Updating auto-fiat payout settings may require email_otp_code when email OTP is enabled (purpose bank_account). See /business/docs/security.