Saltar al contenido principal

Payout Item (for a new Payout)

Each payout item specifies its own channel and channel_data, allowing mixed channels in a single payout. See Create a Payout for full request examples.

Common fields (all channels)​

amountstring

This value must be a numeric string, with up to 18 digits before the decimal point and up to 18 digits after the decimal point.

Minimum amount: 10,000 COP for SAVE/TURBO channels, 100 COP for BREB channel (max 11,500,000 COP). Items below the minimum are automatically rejected with status REJECTED and status_code VALIDATIONS_FAILED.

full_namestring

Full name of the third party.

tokenstring

Stablecoin token for this item. Use COPM in production, testCOPM in sandbox.

legal_identifier_typestring

Legal identifier type of the third party. Valid values: NIT, CC, CE, PP, PPT. PPT (Permiso por Protección Temporal) is accepted for payouts only, with a numeric value of up to 10 digits. Some disbursement rails do not accept every document type: when the rail chosen for an item cannot pay it, the item is rejected with VALIDATIONS_FAILED before any funds move, and its tokens are refunded.

legal_identifierstring

Legal identifier of the third party. This value must be a numeric string.

country_isostring

Country ISO of the third party. Currently only CO.

channelstring

Disbursement channel for this item: SAVE (standard), TURBO (fast), or BREB (instant interbank via BreB keys). Determines the required channel_data fields.

Channel-specific fields​

Required when channel is SAVE or TURBO:

channel_dataBank Account

Bank account details of the third party.