Skip to main content

​
What you’ll build

Send money from your Fintoc Account to a third-party bank account, then track every status change through webhooks. In Mexico, payouts use the Sistema de Pagos Electrónicos Interbancarios (SPEI) rail. In Chile, payouts use the Transferencia Electrónica de Fondos (TEF) rail. Settlement timing depends on the rail.

​
When to use it

Use payouts for these money movement flows:
  • Loan disbursements and refunds.
  • Marketplace payouts to sellers.
  • Wallet withdrawals.
  • Vendor and supplier payments.

​
How it works

​
Implementation checklist

Complete these steps to send a payout:
  1. Fund the source Account. Send money from your company’s external bank account to the root_account_number of your Fintoc Account.
  2. Create the transfer. See Send transfers → Create a transfer for the full request format, examples for Mexico and Chile, and counterparty fields.
  3. Handle the webhooks. See Send transfers → Monitor status for the event catalog and status semantics.
  4. Verify the destination first (optional). If your customer entered the standardized Mexican bank account number (CLABE), see Verify a CLABE before payout.

​
A common pitfall

Webhooks can arrive out of order. Always branch on data.status instead of the event arrival order. See Send transfers → Monitor status for status semantics.