[← Back to Account Payouts docs](/products/account-payouts)
[← Back to Parties docs](/products/parties)
# Colombia
## Domestic payment
### Overview
table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
Colombian Peso (COP)
tr
td
code
countryCode
td
CO
tr
td
Earliest Beneficiary Credit
td
T+1
tr
td
Cut-Off Time (UK Time)
td
12:30
tr
td
Decimal Places
td
2
tr
td
Minimum
code
targetAmount
td
1
tr
td
Maximum
code
targetAmount
td
9999999.99
### Submission data
| API field name | Required? | Field length | Description |
| --- | --- | --- | --- |
| `purposeOfPayment.description` | ✅ | Max 35 | Description for purpose of payment. |
| `beneficiaryBankDetails.accountType` | ✅ | N/A | Account type of the beneficiary.**Available values**:`checking``savings` |
| `beneficiaryBankDetails.accountNumber` | ✅ | Max 18 | The bank account IBAN number of the beneficiary. |
| `beneficiaryBankDetails.bankName` | ✅ | Max 30 | Name of the beneficiary bank. |
| `beneficiaryBankDetails.bankCode` | ✅ | 3 | Code of the beneficiary bank. |
| `beneficiaryBankDetails.swiftBic` | ❌ | 8 or 11 | The SWIFT BIC is the Bank Identification Code of the beneficiary bank. |
| `parties.partyType` | ✅ | N/A | Type of the party.**Must be**:`beneficiary` |
| `parties.personalDetails.type` | ✅ | N/A | Entity description code for the party.**Available values:**`company``person``soleTrader``institution``government` |
| `parties.personalDetails.title` | Conditional | N/A | Title code for the Individual.**Available values**:`ms``mrs` `mr``dr``mx``misc` Mandatory if `parties.personalDetails.type` is:`person` |
| `parties.personalDetails.firstName` | Conditional | Max 50 | Beneficiary first name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.type` is:`person` |
| `parties.personalDetails.middleName` | ❌ | Max 50 | Beneficiary middle name. |
| `parties.personalDetails.lastName` | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.type` is:`person` |
| `parties.personalDetails.companyName` | Conditional | Max 140 | Full name of the organization. Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager. Mandatory if `parties.personalDetails.type` is:`company``institution``government``other` |
| `parties.personalDetails.dateOfBirth` | ❌ | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
| `parties.personalDetails.dateOfIncorporation` | ❌ | 10 | A `company`s date of incorporation in YYYY-MM-DD format. |
| `parties.identityDocuments.type` | ✅ | N/A | Beneficiary's identity type.**Must be**:``nationalId` (CC)
`companyRegistrationNumber` (NIT) |
| `parties.identityDocuments.number` | ✅ | 6-10 | CC (Beneficiary ID) or NIT (Taxpayer ID) |
| `parties.identityDocuments.issuingCountry` | ✅ | 2 | Beneficiary's country code of their identification document.Enter the [2 character ISO 3166-1 standard country code](/products/reference/supported-countries-currencies#iso-country-codes) in your API request. |
| `parties.address.address1` | ✅ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street. |
| `parties.address.address2` | ❌ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio. |
| `parties.address.city` | ❌ | Max 35 | Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.postalCode` | ❌ | 10 | Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.countryCode` | ✅ | 2 | Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address.Enter the [2 character ISO 3166-1 standard country code](/products/reference/supported-countries-currencies#iso-country-codes) in your API request. |
| `parties.personalDetails.email` | ✅ | Max 35 | Beneficiary's email address. |
| `parties.personalDetails.phones.prefix` | ✅ | 1-3 | Beneficiary's phone number country dialing code. |
| `parties.personalDetails.phones.number` | ✅ | 5-15 | Provide the beneficiary's phone number. |
Important
[Additional data](/products/marketplaces/coverage/bank/additionalinfo) is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).
Important
Additional supporting documentation may be required from the beneficiary.
## Domestic wire payment
### Overview
table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
Colombian Peso (COP)
tr
td
code
countryCode
td
CO
tr
td
Earliest Beneficiary Credit
td
T+5
tr
td
Cut-Off Time (UK Time)
td
15:00
tr
td
Decimal Places
td
2
tr
td
Minimum
code
targetAmount
td
0.01
tr
td
Maximum
code
targetAmount
td
9999999.99
### Submission data
| API field name | Required? | Field length | Description |
| --- | --- | --- | --- |
| `purposeOfPayment.description` | ✅ | Max 35 | Description for purpose of payment. |
| `beneficiaryBankDetails.accountType` | ✅ | N/A | Account type of the beneficiary.**Available values**:`checking``savings` |
| `beneficiaryBankDetails.accountNumber` | ✅ | Max 18 | The bank account IBAN number of the beneficiary. |
| `beneficiaryBankDetails.bankName` | ✅ | Max 30 | Name of the beneficiary bank. |
| `beneficiaryBankDetails.bankCode` | ✅ | 3 | Code of the beneficiary bank. |
| `beneficiaryBankDetails.swiftBic` | ❌ | 8 or 11 | The SWIFT BIC is the Bank Identification Code of the beneficiary bank. |
| `parties.partyType` | ✅ | N/A | Type of the party.**Must be**:`beneficiary` |
| `parties.personalDetails.type` | ✅ | N/A | Entity description code for the party.**Available values:**`company``person``soleTrader``institution``government` |
| `parties.personalDetails.title` | Conditional | N/A | Title code for the Individual.**Available values**:`ms``mrs` `mr``dr``mx``misc` Mandatory if `parties.personalDetails.type` is:`person` |
| `parties.personalDetails.firstName` | Conditional | Max 50 | Beneficiary first name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.type` is:`person` |
| `parties.personalDetails.middleName` | ❌ | Max 50 | Beneficiary middle name. |
| `parties.personalDetails.lastName` | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.type` is:`person` |
| `parties.personalDetails.companyName` | Conditional | Max 140 | Full name of the organization. Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager. Mandatory if `parties.personalDetails.type` is:`company``institution``government``other` |
| `parties.personalDetails.dateOfBirth` | ❌ | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
| `parties.personalDetails.dateOfIncorporation` | ❌ | 10 | A `company`s date of incorporation in YYYY-MM-DD format. |
| `parties.identityDocuments.type` | ✅ | N/A | Beneficiary's identity type.**Must be**:`nationalId` (CC)`companyRegistrationNumber` (NIT) |
| `parties.identityDocuments.number` | ✅ | 6-10 | CC (Beneficiary ID) or NIT (Taxpayer ID) |
| `parties.identityDocuments.issuingCountry` | ✅ | 2 | Beneficiary's country code of their identification document.Enter the [2 character ISO 3166-1 standard country code](/products/reference/supported-countries-currencies#iso-country-codes) in your API request. |
| `parties.address.address1` | ✅ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street. |
| `parties.address.address2` | ❌ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio. |
| `parties.address.city` | ❌ | Max 35 | Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.postalCode` | ❌ | 10 | Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.countryCode` | ✅ | 2 | Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address.Enter the [2 character ISO 3166-1 standard country code](/products/reference/supported-countries-currencies#iso-country-codes) in your API request. |
| `parties.personalDetails.email` | ✅ | Max 35 | Beneficiary's email address. |
| `parties.personalDetails.phones.prefix` | ✅ | 1-3 | Beneficiary's phone number country dialing code. |
| `parties.personalDetails.phones.number` | ✅ | 5-15 | Provide the beneficiary's phone number. |
Important
[Additional data](/products/marketplaces/coverage/bank/additionalinfo) is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).
Important
Additional supporting documentation may be required from the beneficiary.
## International WIRE
### Overview
table
tr
td
Available
td
Yes
tr
td
code
targetCurrency
td
a
Available WIRE currencies
tr
td
code
countryCode
td
CO
tr
td
Earliest Beneficiary Credit
td
The estimated delivery time will vary by country and currency.
tr
td
Cut-Off Time (UK Time)
td
a
Currency specific
tr
td
Decimal Places
td
2
tr
td
Minimum
code
targetAmount
td
0.01
tr
td
Maximum
code
targetAmount
td
9999999.99
### Submission data
| API field name | Required? | Field length | Description |
| --- | --- | --- | --- |
| `beneficiaryBankDetails.accountNumber` | ✅ | Max 35 | Account number of the beneficiary. |
| `beneficiaryBankDetails.bankCode` | ❌ | Max 35 | Bank code of the beneficiary (bank). |
| `beneficiaryBankDetails.branchCode` | ❌ | Max 35 | Branch code of the beneficiary (bank). |
| `beneficiaryBankDetails.swift` | ✅ | 8 or 11 | The SWIFT BIC is the Bank Identification Code of the beneficiary bank. |
| `beneficiaryBankDetails.bankName` | ✅ | Max 35 | Name of the beneficiary bank. |
| `parties.partyType` | ✅ | N/A | Type of the party.**Must be**:`beneficiary` |
| `parties.personalDetails.type` | ✅ | N/A | Entity description code for the party.**Available values:**`company``person``soleTrader``institution``government` |
| `parties.personalDetails.title` | Conditional | N/A | Title code for the Individual.**Available values**:`ms``mrs` `mr``dr``mx``misc` Mandatory if `parties.personalDetails.type` is:`person` |
| `parties.personalDetails.firstName` | Conditional | Max 50 | Beneficiary first name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.type` is:`person` |
| `parties.personalDetails.middleName` | ❌ | Max 50 | Beneficiary middle name. |
| `parties.personalDetails.lastName` | Conditional | Max 50 | Beneficiary last name. Full name should be provided (no initials). Mandatory if `parties.personalDetails.type` is:`person` |
| `parties.personalDetails.companyName` | Conditional | Max 140 | Full name of the organization. Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager. Mandatory if `parties.personalDetails.type` is:`company``institution``government``other` |
| `parties.personalDetails.dateOfBirth` | ❌ | 10 | Beneficiary's date of birth in YYYY-MM-DD format. |
| `parties.personalDetails.dateOfIncorporation` | ❌ | 10 | A `company`s date of incorporation in YYYY-MM-DD format. |
| `parties.address.address1` | ❌ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street. |
| `parties.address.address2` | ❌ | Max 35 | Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio. |
| `parties.address.city` | ❌ | Max 35 | Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.postalCode` | ❌ | Max 10 | Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address. |
| `parties.address.countryCode` | Conditional | 2 | Beneficiary's country of their residential (if payee is an individual) or registered (if payee is a company) address. Mandatory if any of the optional Beneficiary address details are provided. Enter the [2 character ISO 3166-1 standard country code](/products/reference/supported-countries-currencies#iso-country-codes) in your API request. |
Important
[Additional data](/products/marketplaces/coverage/bank/additionalinfo) is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).