PSE

（payProduct=12）

支付流程

1. 用户在商户网站/应用下单，并选择PSE支付；

2. 商户向Supefina发起PSE支付请求；

3. Supefina返回PSE支付URL地址；

4. 商户将该地址在用户侧打开；

5. 用户按照页面提示进行验证和支付；

6. 用户支付成功；

7. Supefina将支付成功信息通知商户。

请求地址

环境名称	URL
SandBox	POST https://api.supefina.tech/api/supefina/transactions/payin
正式环境	POST https://api.supefina.net/api/supefina/transactions/payin

请求参数

请求头

Key	Value
Content-Type	application/json

请求体

变量名	类型	必填	描述
countryId	String	是	国家编号 参照：字典表-国家编号 哥伦比亚，COL
currency	String	是	币种 参照：字典表-货币 哥伦比亚比索：COP
orderAmount	String	是	订单金额 3000 >= orderAmount <= 2000000 不支持小数
payProduct	String	是	支付类型 PSE：12
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/TI） 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": "12",
    "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	国家编号 参照：字典表-国家编号 哥伦比亚，COL
customerName	String	用户名字
fee	String	预收手续费
identifier	String	付款参考 Clabe
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",
    "identifier": "706180968985601627",
    "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Á