Our API Docs just got a new look!

🇨🇴Colombia

Country specifications

country code
currency code
amount decimals
document name
document format
document required?

CO

COP and USD

2

NIT

Numeric. Length between 8 and 15.

Yes

Card features

Card-on-file
Subscriptions
3DS
Installments
Authorization and Capture

Brands available

payment_method code CC

Logo
payment_method
Name

VI

Visa

VD

Visa Debit ​

MC

Mastercard

MD

Mastercard Debit ​

AE

American Express

CL

Cabal ​

DC

Diners Club

Alternative Payment Methods available

Logo
payment_method
Name
Payment Type
Flows

ME

MercadoPago

WALLET

Redirect

EY

Efecty

VOUCHER

EmbbededRedirect

PC

PSE

BANK_DEPOSIT

Redirect

NQ

Nequi

BANK_DEPOSIT

EmbbededRedirect

JE

JER

VOUCHER

Redirect

CX

Su Chance

VOUCHER

EmbbededRedirect

XU

Con Suerte

VOUCHER

EmbbededRedirect

XC

Coopenessa

VOUCHER

EmbbededRedirect

DQ

Edeq

VOUCHER

EmbbededRedirect

DX

Dimonex

VOUCHER

EmbbededRedirect

FG

FullCarga

VOUCHER

EmbbededRedirect

MR

Moviired

VOUCHER

EmbbededRedirect

SR

Su Suerte

VOUCHER

EmbbededRedirect

SZ

Surti Mayorista

VOUCHER

EmbbededRedirect

RD

Su Red

VOUCHER

EmbbededRedirect

TRYA

TransFiYa

VOUCHER

EmbbededRedirect

TP

TPAGA

WALLET

EmbbededRedirect

Fields required for the OneShot solution

Payment method name

country

amount

payer[]

payment_method

All

Yes

Yes

Yes

Yes

payer[] object requirements

Payment method name

document

email

first_name

last_name

All

Yes

Yes

Yes

Yes

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


Payment flows

PSE

After choosing PSE, the user completes a basic form and selects their bank* 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.

* 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:

PSE sub_payment_method bank list and codes.
Bank name
sub_payment_method

Rappipay

RPP

Bancamia

BMI

Banco de Bogotá

BDB

Banco Popular

BPC

Banco GNB Sudameris

GNB

Banco Caja Social

BCJ

Banco Agrario

AGR

Banco Davivienda

BDA

Bancolombia

BN

Banco AV Villas

BAV

Bancoomeva

BCM

Banco Finandina

BFB

Banco Cooperativo Coopcentral

BCC

Banco Santander Colombia

SC

Banco Serfinanza

BSF

BBVA Colombia

AV

Lulo Bank

BLU

Dale

DAL

CFA Cooperativa Financiera

CFA

Citibank

CK

Cotrafa

COT

Coofinep Cooperativa Financiera

CCF

Confiar Cooperativa Financiera

CON

Banco Union antes giros

BUG

Coltefinanciera

COL

Daviplata

DVP

Falabella

LL

BAN100 (formerly Banco Credifinanciera)

BCR

Itau

I

Iris

IRS

Movii S.A.

MR

Nequi

NQ

Banco de occidente

OC

Pichincha

IX

Scotiabank Colpatria

ST

Nequi

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.

Last updated

Was this helpful?