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.

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

SAVE / TURBO

Required when channel is SAVE or TURBO:

channel_dataBank Account

Bank account details of the third party.

BREB

Required when channel is BREB:

channel_dataobject

BreB key details of the third party.