Payout Item (for a new Payout)

New Format Available

A new format using channel + channel_data per item is now available. See Create a Payout — New Format for details and examples. The legacy format below will be removed after April 30, 2026.

Legacy Format

The legacy payout item is a discriminated union based on the network field. Each item uses either traditional bank account details or a BreB key, depending on the disbursement network.

Common fields (all networks)

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. Items below this amount will be 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.

networkstring

Network of the third party source. BANK or BREB. Determines which detail fields are required.

Network-specific fields

BANK

Required when network is BANK:

bank_account_detailsBank Account

Bank account details of the third party.

BREB

Required when network is BREB:

payment_detailsobject

BreB key details of the third party.

New Format

In the new format, each item specifies channel + channel_data instead of network + bank_account_details / payment_details. See Create a Payout — New Format for full details, examples, and the channel_data structure reference.