> For the complete documentation index, see [llms.txt](https://apidocs.onekeypayments.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.onekeypayments.com/guides/deposits/payment-methods/america/colombia.md).

# Colombia

### Country specifications

<table><thead><tr><th align="center">country code</th><th align="center">currency code</th><th width="137.60546875" align="center">amount decimals</th><th>document name</th><th width="145.94140625">document format</th><th align="center">document required?</th></tr></thead><tbody><tr><td align="center"><code>CO</code></td><td align="center"><code>COP</code> and <code>USD</code></td><td align="center">2</td><td>NIT</td><td>Numeric. Length between 8 and 15.</td><td align="center">Yes</td></tr></tbody></table>

### Card features

<table><thead><tr><th data-type="checkbox">Card-on-file</th><th width="129.93359375" data-type="checkbox">Subscriptions</th><th width="129.515625" data-type="checkbox">3DS</th><th width="130.22265625" data-type="checkbox">Installments</th><th width="205.6328125" data-type="checkbox">Authorization and Capture</th></tr></thead><tbody><tr><td>false</td><td>false</td><td>true</td><td>false</td><td>false</td></tr></tbody></table>

***

### Brands available

{% hint style="success" %}

### `payment_method` code `CC`

As the payers will be capable to input any card in the displayed checkout form ,the OneShot and Fragments all-in-one solution, we recommend using the payment method code **`CC`**  in the API requests, which is a generic code.

After the payment is attempted, merchants will be capable to know with which card the user paid.
{% endhint %}

<table><thead><tr><th width="95.140625" align="center">Logo</th><th width="160.26171875" align="center">payment_method</th><th width="188.76171875">Name</th></tr></thead><tbody><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/VI.svg" alt="" data-size="original"></td><td align="center"><code>VI</code></td><td>Visa</td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/VD.svg" alt="" data-size="original"></td><td align="center"><code>VD</code></td><td>Visa Debit ​</td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/MC.svg" alt="" data-size="original"></td><td align="center"><code>MC</code></td><td>Mastercard</td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/MD.svg" alt="" data-size="original"></td><td align="center"><code>MD</code></td><td>Mastercard Debit ​</td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/AE.svg" alt="" data-size="original"></td><td align="center"><code>AE</code></td><td>American Express</td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/CL.svg" alt="" data-size="original"></td><td align="center"><code>CL</code></td><td>Cabal ​</td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/DC.svg" alt="" data-size="original"></td><td align="center"><code>DC</code></td><td>Diners Club</td></tr></tbody></table>

### Alternative Payment Methods available

<table><thead><tr><th width="94.6640625" align="center">Logo</th><th width="160.046875" align="center">payment_method</th><th width="189.09765625">Name</th><th width="175.171875" align="center">Payment Type</th><th>Flows<select multiple><option value="LIOcwzyGDuFo" label="Embbeded" color="blue"></option><option value="ktJwcQfbvqut" label="Redirect" color="blue"></option></select></th></tr></thead><tbody><tr><td align="center"><img src="/files/Fa6IKG6eZuoacQUQkLnU" alt=""></td><td align="center"><code>BREB</code></td><td>BREB</td><td align="center"><code>BANK_TRANSFER</code></td><td><span data-option="ktJwcQfbvqut">Redirect, </span><span data-option="LIOcwzyGDuFo">Embbeded</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/ME.svg" alt="" data-size="original"></td><td align="center"><code>ME</code></td><td>MercadoPago</td><td align="center"><code>WALLET</code></td><td><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/EY.svg" alt="" data-size="original"></td><td align="center"><code>EY</code></td><td>Efecty</td><td align="center"><code>VOUCHER</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/PC.svg" alt="" data-size="original"></td><td align="center"><code>PC</code></td><td>PSE</td><td align="center"><code>BANK_DEPOSIT</code></td><td><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="/files/ROIunVdHULjbdKAbHgza" alt="" data-size="original"></td><td align="center"><code>NQ</code></td><td>Nequi</td><td align="center"><code>BANK_DEPOSIT</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/JE.svg" alt="" data-size="original"></td><td align="center"><code>JE</code></td><td>JER</td><td align="center"><code>VOUCHER</code></td><td><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/CX.svg" alt="" data-size="original"></td><td align="center"><code>CX</code></td><td>Su Chance</td><td align="center"><code>VOUCHER</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/XU.svg" alt="" data-size="original"></td><td align="center"><code>XU</code></td><td>Con Suerte</td><td align="center"><code>VOUCHER</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/XC.svg" alt="" data-size="original"></td><td align="center"><code>XC</code></td><td>Coopenessa</td><td align="center"><code>VOUCHER</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/DQ.svg" alt="" data-size="original"></td><td align="center"><code>DQ</code></td><td>Edeq</td><td align="center"><code>VOUCHER</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/DX.svg" alt="" data-size="original"></td><td align="center"><code>DX</code></td><td>Dimonex</td><td align="center"><code>VOUCHER</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/FG.svg" alt="" data-size="original"></td><td align="center"><code>FG</code></td><td>FullCarga</td><td align="center"><code>VOUCHER</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/MR.svg" alt="" data-size="original"></td><td align="center"><code>MR</code></td><td>Moviired</td><td align="center"><code>VOUCHER</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/SR.svg" alt="" data-size="original"></td><td align="center"><code>SR</code></td><td>Su Suerte</td><td align="center"><code>VOUCHER</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/SZ.svg" alt="" data-size="original"></td><td align="center"><code>SZ</code></td><td>Surti Mayorista</td><td align="center"><code>VOUCHER</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="https://resources.directa24.com/cashin/payment_method/square/RD.svg" alt=""><img src="https://resources.directa24.com/cashin/payment_method/square/RD.svg" alt="" data-size="line"></td><td align="center"><code>RD</code></td><td>Su Red</td><td align="center"><code>VOUCHER</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="/files/q9AAOLOS5ERy5Vw7hMpQ" alt="" data-size="original"></td><td align="center"><code>TRYA</code></td><td>TransFiYa</td><td align="center"><code>VOUCHER</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr><tr><td align="center"><img src="/files/ILdIU8aEY31sHCoRlc6Z" alt="" data-size="original"></td><td align="center"><code>TP</code></td><td>TPAGA</td><td align="center"><code>WALLET</code></td><td><span data-option="LIOcwzyGDuFo">Embbeded, </span><span data-option="ktJwcQfbvqut">Redirect</span></td></tr></tbody></table>

#### Fields required for the [OneShot](/guides/deposits/solutions/oneshot.md) solution <a href="#fields-required-for-the-oneshot-experience" id="fields-required-for-the-oneshot-experience"></a>

<table data-header-hidden><thead><tr><th width="230.625">Payment Method Name</th><th width="99.52734375" align="center">country</th><th width="109.91796875" align="center">amount</th><th width="109.78515625" align="center">payer[]</th><th width="150.27734375" align="center">payment_method</th></tr></thead><tbody><tr><td><strong>Payment method name</strong></td><td align="center"><strong><code>country</code></strong></td><td align="center"><strong><code>amount</code></strong></td><td align="center"><strong><code>payer[]</code></strong></td><td align="center"><strong><code>payment_method</code></strong></td></tr><tr><td>All</td><td align="center">Yes</td><td align="center">Yes</td><td align="center">Yes</td><td align="center">Yes</td></tr></tbody></table>

#### `payer[]` object requirements <a href="#payer-object-requirements" id="payer-object-requirements"></a>

<table data-header-hidden><thead><tr><th width="230.6015625">Payment Method Name</th><th width="100.12109375" align="center">document</th><th align="center">email</th><th align="center">first_name</th><th align="center">last_name</th></tr></thead><tbody><tr><td><strong>Payment method name</strong></td><td align="center"><strong><code>document</code></strong></td><td align="center"><strong><code>email</code></strong></td><td align="center"><strong><code>first_name</code></strong></td><td align="center"><strong><code>last_name</code></strong></td></tr><tr><td>All</td><td align="center">Yes</td><td align="center">Yes</td><td align="center">Yes</td><td align="center">Yes</td></tr></tbody></table>

{% hint style="success" %}
Other fields not in these lists are optional.
{% endhint %}

{% hint style="info" %}

### If any of the required fields are missing the `HOSTED` flow will be triggered

In that case you will receive the `HOSTED` value in the `checkout_type` parameter.\
You will have to redirect the user to the `redirect_url`
{% endhint %}

***

### Payment flows

#### PSE

<figure><img src="/files/rjKxer42PN7O4IcrovN0" alt=""><figcaption></figcaption></figure>

After choosing **PSE**, the user completes a basic form and **selects their bank**<mark style="color:red;">**\***</mark> from a list. They are securely **redirected** to their online banking environment to review and authorize the payment. Once confirmed, the transaction is processed immediately.

&#x20;<mark style="color:red;">**\***</mark> Merchants can avoid the first redirection to our checkout where the user needs to select their bank. \
In order to do so, merchants should display on their checkout a dropdown/scrollable list for the users to select their bank and afterwards add the **`sub_payment_method`** field to the deposit request to use this flow.  \
Below you will find the list of banks:

<details>

<summary>PSE <code>sub_payment_method</code> bank list and codes.</summary>

<table><thead><tr><th width="225.9453125">Bank name</th><th width="203.79296875" align="center">sub_payment_method</th></tr></thead><tbody><tr><td>Rappipay</td><td align="center"><code>RPP</code></td></tr><tr><td>Bancamia</td><td align="center"><code>BMI</code></td></tr><tr><td>Banco de Bogotá</td><td align="center"><code>BDB</code></td></tr><tr><td>Banco Popular</td><td align="center"><code>BPC</code></td></tr><tr><td>Banco GNB Sudameris</td><td align="center"><code>GNB</code></td></tr><tr><td>Banco Caja Social</td><td align="center"><code>BCJ</code></td></tr><tr><td>Banco Agrario</td><td align="center"><code>AGR</code></td></tr><tr><td>Banco Davivienda</td><td align="center"><code>BDA</code></td></tr><tr><td>Bancolombia</td><td align="center"><code>BN</code></td></tr><tr><td>Banco AV Villas</td><td align="center"><code>BAV</code></td></tr><tr><td>Bancoomeva</td><td align="center"><code>BCM</code></td></tr><tr><td>Banco Finandina</td><td align="center"><code>BFB</code></td></tr><tr><td>Banco Cooperativo Coopcentral</td><td align="center"><code>BCC</code></td></tr><tr><td>Banco Santander Colombia</td><td align="center"><code>SC</code></td></tr><tr><td>Banco Serfinanza</td><td align="center"><code>BSF</code></td></tr><tr><td>BBVA Colombia</td><td align="center"><code>AV</code></td></tr><tr><td>Lulo Bank</td><td align="center"><code>BLU</code></td></tr><tr><td>Dale</td><td align="center"><code>DAL</code></td></tr><tr><td>CFA Cooperativa Financiera</td><td align="center"><code>CFA</code></td></tr><tr><td>Citibank</td><td align="center"><code>CK</code></td></tr><tr><td>Cotrafa</td><td align="center"><code>COT</code></td></tr><tr><td>Coofinep Cooperativa Financiera</td><td align="center"><code>CCF</code></td></tr><tr><td>Confiar Cooperativa Financiera</td><td align="center"><code>CON</code></td></tr><tr><td>Banco Union antes giros</td><td align="center"><code>BUG</code></td></tr><tr><td>Coltefinanciera</td><td align="center"><code>COL</code></td></tr><tr><td>Daviplata</td><td align="center"><code>DVP</code></td></tr><tr><td>Falabella</td><td align="center"><code>LL</code></td></tr><tr><td>BAN100 (formerly Banco Credifinanciera)</td><td align="center"><code>BCR</code></td></tr><tr><td>Itau</td><td align="center"><code>I</code></td></tr><tr><td>Iris</td><td align="center"><code>IRS</code></td></tr><tr><td>Movii S.A.</td><td align="center"><code>MR</code></td></tr><tr><td>Nequi</td><td align="center"><code>NQ</code></td></tr><tr><td>Banco de occidente</td><td align="center"><code>OC</code></td></tr><tr><td>Pichincha</td><td align="center"><code>IX</code></td></tr><tr><td>Scotiabank Colpatria</td><td align="center"><code>ST</code></td></tr></tbody></table>

</details>

#### Nequi

<figure><img src="/files/hG9HUdSqrHUSzOrJXFlB" alt=""><figcaption></figcaption></figure>

The user selects **Nequi**, enters required personal information, and a **QR code** is generated. They download or scan it using their Nequi app, confirm the transaction within the app, and the payment is instantly processed.

<br>
