Skip to main content

Colombia

TOPPAY TeamAbout 3 min

Country domains & codes (Colombia)

Country/RegionCountry CodeDomainCurrency CodeCurrency Name
Colombiacoglobal-co-openapi.toppayment.comCOPColombian Peso

Domain: Prefer the unified host openapi.toppayment.com (path unchanged); legacy country domains remain available.

Sandbox/production hostnames depend on your account setup; URL patterns follow the same convention as other regions: /sandbox/{countryCode}/... (sandbox) and /{countryCode}/... (production).

Pay-In method codes (method)

Use these values in the method field for Colombia Pay-In (/pay/prePay):

Method codeDescription
PSEPSE bank debit / online banking flows
NEQUINEQUI wallet
BRE-B-LLAVEBre-B Llave
CASHCash-style checkout

If additional method values are enabled by the gateway, follow the live response and the list provided by operations. Open-API field descriptions and examples: Pay-In Orders — Colombia.

Amount format (Pay-In / Pay-Out)

Positive amount, integer or at most 2 decimal places; not all zeros; no three or more decimal places. See amount in Pay-In Orders — Colombia and Pay-Out Orders — Colombia.

Pay-In notification rules (split credits, same as Mexico)

For Colombia Pay-In, one merchant order (orderNum) may receive multiple incoming credits and multiple success-style callbacks. The handling rules are the same as in Mexico — Regional Payment Guide, section Pay-In notification rules (SPEI / same CLABE, multiple credits):

  • orderNum: unchanged across callbacks.
  • platOrderNum: may differ per credited event (multiple platform order numbers).
  • Paid-amount style fields (e.g. payMoney; names vary by gateway): may represent the amount for that specific callback and may differ between notifications; not required to match the original order amount.

Integration guidance: use platOrderNum as the primary idempotency / ledger key and book each notification separately.

Examples (field names per live gateway; method is illustrative):

First credit notification:

{
  "code": "00",
  "description": "desc",
  "method": "PSE",
  "msg": "SUCCESS",
  "orderNum": "TEST00000000000001",
  "payFee": "3",
  "payMoney": "25",
  "platOrderNum": "PRE10262034203986608803927",
  "platSign": "…",
  "status": "SUCCESS"
}

Second credit notification (same orderNum, different platOrderNum and payMoney):

{
  "code": "00",
  "description": "desc",
  "method": "PSE",
  "msg": "SUCCESS",
  "orderNum": "TEST00000000000001",
  "payFee": "3",
  "payMoney": "15",
  "platOrderNum": "SUB1034205556524208141",
  "platSign": "…",
  "status": "SUCCESS"
}

Colombia ID types (Pay-Out documentType)

Values accepted in Pay-Out documentType (case-insensitive).

CodeDescription
CCCédula de ciudadanía
CECédula de extranjería
NITTax ID (Número de Identificación Tributaria)
PASPassport

Colombia Pay-Out account types (accountType)

Values accepted in Pay-Out accountType (case-insensitive). For Bre-B, prefer the hyphenated form BRE-B in external documents.

CodeDescription
CORRIENTEChecking
AHORROSSavings
BRE-BBre-B account type
WALLETWallet

Pay-Out banks & codes (bankCode / bankName)

These codes are used for Colombia Pay-Out create/query (/disbursement/cash, /disbursement/query) as bankCode and display bankName. Channel is the gateway routing bucket (Wallet / Transfer); Category is bank vs wallet. Request body details: Pay-Out Orders — Colombia.

bankCodebankNameChannelCategory
DAVIPLATADAVIPLATAWalletWallet
NEQUINEQUIWalletWallet
RAPPIPAYRAPPIPAYWalletWallet
MOVIIMOVIIWalletWallet
IRISIRISWalletWallet
DALEDALEWalletWallet
BANCAMIABANCAMIATransferBank
AGRARIOBANCO AGRARIOTransferBank
SOCIALBANCO CAJA SOCIALTransferBank
COOPERATIVOBANCO COOPERATIVO COOPCENTRALTransferBank
CREDIFINANCIERABANCO CREDIFINANCIERATransferBank
DE_BOGOTABANCO DE BOGOTATransferBank
DE_OCCIDENTEBANCO DE OCCIDENTETransferBank
FALABELLABANCO FALABELLATransferBank
POPULARBANCO POPULARTransferBank
SERFINANZABANCO SERFINANZATransferBank
GNB_SUDAMERISBANCO_GNB_SUDAMERISTransferBank
BANCOLOMBIABANCOLOMBIATransferBank
BANCOOMEVABANCOOMEVATransferBank
BBVABBVATransferBank
CITIBANKCITIBANKTransferBank
COLTEFINANCIERACOLTEFINANCIERATransferBank
COOFINEPCOOFINEPTransferBank
DAVIVIENDADAVIVIENDATransferBank
ITAUITAUTransferBank
LULOLULO BANKTransferBank
PICHINCHAPICHINCHATransferBank
SCOTIABANKSCOTIABANK COLPATRIATransferBank
COTRAFACOTRAFATransferBank
CFA_COOPERATIVACFA COOPERATIVA FINANCIERATransferBank
BANCO_UNIONBANCO UNION antes GIROSTransferBank
SANTANDERBANCO SANTANDER COLOMBIATransferBank
AV_VILLASBANCO AV VILLASTransferBank
BANCOLDEX_SABANCOLDEX S.A.TransferBank
BNP_PARIBASBNP PARIBAS COLOMBIATransferBank
MUNDO_MUJERBANCO MUNDO MUJERTransferBank
BANCO_WBANCO WTransferBank
MIBANCO_SAMIBANCO S.A.TransferBank
JPM_SABANCO J.P. MORGAN COLOMBIA S.A.TransferBank
FJ_SA_CDFFINANCIERA JURISCOOP S.A. COMPAÑIA DE FINANCIAMIENTOTransferBank
JFK_CFJFK COOPERATIVA FINANCIERATransferBank
COOTRAFA_CFCOOTRAFA COOPERATIVA FINANCIERATransferBank
CONFIAR_CFCONFIAR COOPERATIVA FINANCIERATransferBank
BAN100_SABAN100 S.ATransferBank
PIBANKPIBANKTransferBank
DING_TECNIPAGOSDING TECNIPAGOS SATransferBank
POWWIPOWWITransferBank
UALAUALATransferBank
BTG_PACTUALBANCO BTG PACTUALTransferBank
BOLD_CFBOLD CFTransferBank
NUNU COLOMBIATransferBank
COINKCOINKTransferBank
SANTANDER_CONSUMERSANTANDER CONSUMERTransferBank
GLOBAL66GLOBAL66TransferBank
CONTACTARBANCO CONTACTARTransferBank

For status on Pay-In and Pay-Out, see Transaction Status Codes.

Copyright © 2026 TOPPAY Team