跳至主要內容

哥伦比亚

TOPPAY Team大约 4 分钟

国家域名及编码（哥伦比亚）

国家/地区国家编码域名货币代码货币名称
哥伦比亚coglobal-co-openapi.toppayment.comCOP哥伦比亚比索

域名：推荐使用统一域名 openapi.toppayment.com（路径不变）；原国别域名仍可继续使用。

实际域名与商户环境以运营配置为准；路径模板与其他国家一致：/sandbox/{countryCode}/...（沙箱）、/{countryCode}/...（生产）。

代收支付方式编码（method）

调用哥伦比亚代收接口（/pay/prePay）时，在 method 传递下列编码：

支付方式编码说明
PSEPSE 网银借记等
NEQUINEQUI 钱包
BRE-B-LLAVEBre-B Llave
CASH现金类收银

若网关扩展更多 method，以接口返回与运营下发清单为准。开放接口字段及示例见 代收订单-哥伦比亚。

金额格式（代收 / 代付）

正数金额，整数或最多两位小数；不允许全为 0；不允许三位及以上小数。各接口请求体中的 amount 说明见 代收订单-哥伦比亚、代付订单-哥伦比亚。

代收通知规则（多笔到账，与墨西哥一致）

哥伦比亚代收在同一笔商户订单（同一 orderNum）下，可能出现分多笔入账、多笔成功类回调的情形；处理规则与 墨西哥 — 地区支付说明 中「代收通知规则（SPEI / 同一 CLABE 多笔到账）」一致：

  • orderNum：多次回调中保持不变。
  • platOrderNum：每笔到账事件可对应不同平台单号（多个平台订单号）。
  • 实付金额类字段（如 payMoney 等，以网关实际字段名为准）：可表示该次回调对应的单笔实收金额，各次通知可以不同；不要求与下单金额一致。

商户处理建议：以 platOrderNum 作为入账与幂等校验的主键，对每笔通知单独记账、对账。

示意（字段名以实际回调为准；method 仅为示例）：

第一次到账通知示例：

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

第二次到账通知示例（同一 orderNum，不同 platOrderNum 与 payMoney）：

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

哥伦比亚证件类型（代付 documentType）

与开放接口代付侧 documentType 取值一致（忽略大小写）。

编码说明
CC公民身份证（Cédula de ciudadanía）
CE外国人身份证（Cédula de extranjería）
NIT税号（Número de Identificación Tributaria）
PAS护照

哥伦比亚代付账户类型（accountType）

与开放接口代付侧 accountType 取值一致（忽略大小写）。对外书写 Bre-B 相关取值时建议使用连字符 BRE-B。

编码说明
CORRIENTE活期账户
AHORROS储蓄账户
BRE-BBre-B 类账户
WALLET钱包

代付银行及对应编码（bankCode / bankName）

以下编码用于哥伦比亚代付订单创建与查询（/disbursement/cash、/disbursement/query）的 bankCode 与展示名 bankName。渠道为网关侧路由分类（Wallet / Transfer），类型为银行或钱包。代付请求体字段及示例见 代付订单-哥伦比亚。

bankCodebankName渠道类型
DAVIPLATADAVIPLATAWallet钱包
NEQUINEQUIWallet钱包
RAPPIPAYRAPPIPAYWallet钱包
MOVIIMOVIIWallet钱包
IRISIRISWallet钱包
DALEDALEWallet钱包
BANCAMIABANCAMIATransfer银行
AGRARIOBANCO AGRARIOTransfer银行
SOCIALBANCO CAJA SOCIALTransfer银行
COOPERATIVOBANCO COOPERATIVO COOPCENTRALTransfer银行
CREDIFINANCIERABANCO CREDIFINANCIERATransfer银行
DE_BOGOTABANCO DE BOGOTATransfer银行
DE_OCCIDENTEBANCO DE OCCIDENTETransfer银行
FALABELLABANCO FALABELLATransfer银行
POPULARBANCO POPULARTransfer银行
SERFINANZABANCO SERFINANZATransfer银行
GNB_SUDAMERISBANCO_GNB_SUDAMERISTransfer银行
BANCOLOMBIABANCOLOMBIATransfer银行
BANCOOMEVABANCOOMEVATransfer银行
BBVABBVATransfer银行
CITIBANKCITIBANKTransfer银行
COLTEFINANCIERACOLTEFINANCIERATransfer银行
COOFINEPCOOFINEPTransfer银行
DAVIVIENDADAVIVIENDATransfer银行
ITAUITAUTransfer银行
LULOLULO BANKTransfer银行
PICHINCHAPICHINCHATransfer银行
SCOTIABANKSCOTIABANK COLPATRIATransfer银行
COTRAFACOTRAFATransfer银行
CFA_COOPERATIVACFA COOPERATIVA FINANCIERATransfer银行
BANCO_UNIONBANCO UNION antes GIROSTransfer银行
SANTANDERBANCO SANTANDER COLOMBIATransfer银行
AV_VILLASBANCO AV VILLASTransfer银行
BANCOLDEX_SABANCOLDEX S.A.Transfer银行
BNP_PARIBASBNP PARIBAS COLOMBIATransfer银行
MUNDO_MUJERBANCO MUNDO MUJERTransfer银行
BANCO_WBANCO WTransfer银行
MIBANCO_SAMIBANCO S.A.Transfer银行
JPM_SABANCO J.P. MORGAN COLOMBIA S.A.Transfer银行
FJ_SA_CDFFINANCIERA JURISCOOP S.A. COMPAÑIA DE FINANCIAMIENTOTransfer银行
JFK_CFJFK COOPERATIVA FINANCIERATransfer银行
COOTRAFA_CFCOOTRAFA COOPERATIVA FINANCIERATransfer银行
CONFIAR_CFCONFIAR COOPERATIVA FINANCIERATransfer银行
BAN100_SABAN100 S.ATransfer银行
PIBANKPIBANKTransfer银行
DING_TECNIPAGOSDING TECNIPAGOS SATransfer银行
POWWIPOWWITransfer银行
UALAUALATransfer银行
BTG_PACTUALBANCO BTG PACTUALTransfer银行
BOLD_CFBOLD CFTransfer银行
NUNU COLOMBIATransfer银行
COINKCOINKTransfer银行
SANTANDER_CONSUMERSANTANDER CONSUMERTransfer银行
GLOBAL66GLOBAL66Transfer银行
CONTACTARBANCO CONTACTARTransfer银行

代收与代付订单 status 字段取值说明见 交易状态码。

Copyright © 2026 TOPPAY Team