Bancolombia

（payProduct=28）

最后更新于5个月前

Bancolombia

（payProduct=28）

支付流程

用户在商户网站/应用下单，并选择Bancolombia支付；
商户向Supefina发起Bancolombia支付请求；
Supefina返回Bancolombia支付URL地址；
商户将该地址在用户侧打开；
用户按照页面提示进行验证和支付；
用户支付成功；
Supefina将支付成功信息通知商户。

请求地址

环境名称

URL

SandBox

POST http://8.130.9.219:8899/api/supefina/transactions/payin

正式环境

POST https://api.supefina.net/api/supefina/transactions/payin

请求参数

请求头

Key

Value

Content-Type

application/json

请求体

变量名

类型

必填

描述

countryId

String

是

currency

String

是

orderAmount

String

是

订单金额 3000 >= orderAmount <= 2000000

不支持小数

payProduct

String

是

merId

String

是

商户ID 商户ID获取路径：Supefina商户后台-商户管理-基本信息-商户ID

merOrderNo

String

是

商户订单号

sign

String

是

nonceStr

String

是

随机字符串长度不能超过32位

customerEmail

String

是

用户邮箱邮箱用户名不能只有数字（例如[email protected]）

且同一个邮箱一天支付请求不能超过20次。

customerName

String

是

用户名字

customerPhone

String

是

用户电话需以3开头的十位数

customerIdentification

String

是

用户证件号

checkOut

Boolean

是

收银台 true：需要收银台 false：不需要收银台建议传true

customerAccount

String

否

用户账户 checkOut为false时必传

lastName

String

否

用户姓氏 checkOut为false时必传

customerIdentificationType

String

否

用户证件类型 00：身份证（CC） 01：外国人身份证（CE） 02：税号 03：护照 06：其他 07：公民身份证明 08：居留许可证

checkOut为false时必传

customerAddress

String

否

用户地址 checkOut为false时必传

tipo_persona

String

否

付款主体 checkOut为false时必传

bankId

String

否

银行编码参照：https://api.supefina.net/api/supefina/transactions/internal/getEbixuBankList checkOut为false时必传

expireTimeL

Long

否

过期时间单位：秒；默认值：10分钟，最大值：10分钟

callbackUrl

String

否

回调地址

description

String

是

描述

不能带特殊符号,长度不超过200字符

请求示例

{
    "callbackUrl": "https://d3vf2zxd9jv8rh.cloudfront.net/apigate/v6sx2i/api/pay_notice/in_payback/payId/CDEA3CA37DBC4C2CB6301AED14011122",
    "checkOut": true,
    "countryId": "COL",
    "currency": "COP",
    "customerAccount": "60872832",
    "customerEmail": "[email protected]",
    "customerIdentification": "9145652857",
    "customerName": "Aaliyah Rogers",
    "customerPhone": "3073030686",
    "lastName": "cith",
    "merId": "8301113635310326",
    "merOrderNo": "R20240619032018545",
    "nonceStr": "6D9B18BFD37240EB846FC923059D001B",
    "orderAmount": "20000",
    "payProduct": "28",
    "sign": "727D7B7416A570284E97F295DECF8490",
    "description":"Supefina"
}

响应参数

变量名

类型

描述

code

String

msg

String

响应信息

data

Object

响应数据

merCode

String

商户ID

merOrderNo

String

商户订单号

supefinaOrderId

String

supefina订单号

amount

BigDecimal

订单金额

fee

String

预收手续费

identifier

String

付款参考

transactionStatus

String

下单状态该笔订单的的发起状态是否成功，与订单真正的交易状态无关。 00：下单成功 04：下单失败

url

String

交易链接

响应示例

{
    "code": "string",
    "msg": "string",
    "data": {
        "merCode": "string",
        "merOrderNo": "string",
        "supefinaOrderNo": "string",
        "amount": 0,
        "fee": 0,
        "transactionStatus": "string",
        "url": "string",
        "identifier": "string"
    }
}

回调通知

提交方式：POST

变量名

类型

描述

amount

String

订单金额

countryId

String

customerName

String

用户名字

fee

String

预收手续费

merId

String

商户ID

merOrderId

String

商户订单号

msg

String

消息

nonceStr

String

随机字符串长度不能超过32位

realityAmount

String

实收金额

realityFee

String

实收手续费

sign

String

签名

status

String

successTime

Date

交易成功时间 UTC时间

supefinaOrderId

String

supefina订单号

transactionType

String

交易类型 01：代收 02：代付

回调通知示例

{
    "amount": "20000.00",
    "countryId": "COL",
    "customerName": "Grace Shaw",
    "fee": "1000.00",
    "merId": "8301409897370054",
    "merOrderId": "R20240619052050314",
    "msg": "",
    "nonceStr": "8b0c8dcd-14b6-4fef-a970-c914dc",
    "realityAmount": "20000",
    "realityFee": "1000.00",
    "sign": "FD1DD91503C4EC282E8CA01591973921",
    "status": "01",
    "successTime": 1718775146000,
    "supefinaOrderId": "2024061900010012b16f19beca043",
    "transactionType": "01"
}

回调通知响应

商户成功收到回调后需同步返回指定字符串：SUCCESS 不返回或返回其他内容默认通知失败如：

public String test(){
	return "SUCCESS";
}

哥伦比亚代收银行列表

银行编号

银行名称

1558

BAN100

1059

BANCAMIA S.A.

1040

BANCO AGRARIO

1052

BANCO AV VILLAS

1013

BANCO BBVA COLOMBIA S.A.

1032

BANCO CAJA SOCIAL

1066

BANCO COOPERATIVO COOPCENTRAL

1051

BANCO DAVIVIENDA

1001

BANCO DE BOGOTA

1023

BANCO DE OCCIDENTE

1062

BANCO FALABELLA

1063

BANCO FINANDINA S.A. BIC

1012

BANCO GNB SUDAMERIS

1006

BANCO ITAU

1060

BANCO PICHINCHA S.A.

1002

BANCO POPULAR

1065

BANCO SANTANDER COLOMBIA

1069

BANCO SERFINANZA

1303

BANCO UNION antes GIROS

1007

BANCOLOMBIA

1061

BANCOOMEVA S.A.

1283

CFA COOPERATIVA FINANCIERA

1009

CITIBANK

1370

COLTEFINANCIERA

1292

CONFIAR COOPERATIVA FINANCIERA

1291

COOFINEP COOPERATIVA FINANCIERA

1289

COTRAFA

1097

DALE

1551

DAVIPLATA

1637

IRIS

1070

LULO BANK

1801

MOVII S.A.

1507

NEQUI

1811

RAPPIPAY

1019

SCOTIABANK COLPATRIA

1815

ALIANZA FIDUCIARIA

1071

BANCO J.P. MORGAN COLOMBIA S.A.

1047

BANCO MUNDO MUJER S.A.

1816

CREZCAMOS S.A. COMPAÑÍA DE FINANCIAMIENTO

1804

UALÁ

最后更新于5个月前