Going live

Fiat & auto-payouts

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

Fiat capability endpoints

This page covers developer-relevant fiat payout APIs and automation controls exposed publicly. This page intentionally excludes internal admin/operator APIs.

  • GET /v1/merchant/fiat/corridors, available fiat corridors.
  • GET /v1/merchant/fiat/institutions , available fiat institutions per corridor.
  • POST /v1/merchant/fiat/beneficiary/resolve , resolve beneficiary details before payout creation.

Automatic fiat payout settings

Enable/disable automatic fiat payout behavior per environment. Automatic: enabled policy triggers payout flow as eligible funds arrive.

curl $XPEND_BASE/v1/merchant/auto-fiat-payout-settings \
  -H "Authorization: Bearer $XPEND_SECRET_KEY"

Manual versus automatic payouts

Automation needs guardrails

Keep automation behind admin workflows, audit changes, and require payout security controls where appropriate.
  • Manual: explicit POST /v1/payouts call per business action.
  • Automatic: policy-driven; funds settle to the configured destination automatically.
  • Switch carefully between modes, keep traffic on one mode per environment for clean ops.