PayOut API
Use this API to initiate disbursements to bank accounts and supported wallets. Supported methods by country:- Colombia:
BANK_TRANSFER,TRANSFIYA,TUMIPAY,BREB(see Bre-B integration) - Peru:
BANK_TRANSFER - Mexico:
SPEI - Guatemala:
BANK_TRANSFER - Honduras:
BANK_TRANSFER
Transaction Flow
The PayOut process follows a clear sequence of interactions between different participants:Preauthorization Rules
Preauthorization, limits and validations depend on each country and method. Refer to the country pages for current values and processes.Endpoints
POST Initiate a PayOut Transaction
/api/v1/payout
This endpoint allows you to perform dispersions using methods like TumiPay Wallet and Bank Transfer.
Transactions are processed asynchronously, ensuring efficiency and reliability.
Request Headers
Request Body
Response
Response code (see Error Codes)
Examples for Mexico
SPEI
Disbursement via SPEI to a CLABE account. The 18-digit CLABE uniquely identifies the destination bank and account.account_number must be the account segment of clabe_number (10 to 12 digits), not the full CLABE. See CLABE validation.Error Codes
Supported Banks
For a complete list of supported banks for PayOut transactions, please refer to the country-specific documentation:- Colombia - Supported Banks
- Peru - Supported Banks
- Guatemala - Supported Banks
- Mexico - SPEI transfers route via the national CLABE system; no specific bank selection is required
Valid Account Types
The following account types are valid for processing transactions through this API.
Always use the corresponding account type in your API requests to ensure proper processing of the transaction.
Common Bank Response Messages for “REJECTED” Status
When a payout transaction is rejected, thetop_response_message field in the webhook payload contains a message provided by the bank explaining the reason for the rejection.
These messages should be monitored and logged to understand the reason for the rejection and take any necessary corrective actions.
Response Examples
Error Response