For AI agents: visit https://doc.futurepay.global/llms.txt for an index of all pages formatted in Markdown and endpoints in OpenAPI. Append .md to any documentation page URL to get its markdown version.
字段名称 内容 可用国家代码 哥伦比亚(CO) 消费者货币 COP 处理货币 COP 结算货币 美元 (USD) 类型 I 银行转账 (bankTransfer) 类型 II pseco会话超时 30分钟 退款 不支持退款 拒付 无 集成类型 异步
消费者在商家的结账页面选择PSE付款并选择对应银行、填写个人信息。
消费者被重定向银行支付信息页面。
消费者在网上银行完成支付。
消费者完成交易。
消费者被重定向对应页面。
参数名 类型 必填 说明 referenceString 是 订单唯一标识 amountObject 是 订单金额信息 ├── currency String 是 货币类型（如 COP） ├── value Number 是 金额数值，单位为最小货币单位 productDetailString 是 订单描述 countryCodeString 是 国家代码（如 CO） originString 是 订单来源，如商城域名 paymentMethodObject 是 支付方式信息 ├── shopperEmail String 是 付款人邮箱 ├── type String 是 支付方式（如 pseco） ├── telephoneNumber String 是 电话号码 ├── holderName String 是 姓名 ├── bankName String 是 银行code ├── taxType String 是 身份类型 ├── personalTaxId String 是 对应身份类型号码 returnUrlString 是 支付完成后返回的 URL shopperReferenceString 是 付款人唯一标识
JSON
{
"amount": {
"currency": "COP",
"value": 1000
},
"countryCode": "CO",
"merchantId": "1945765992684761088",
"origin": "fffmall.com",
"paymentMethod": {
"shopperEmail": "[email protected] ",
"holderName": "JW L",
"bankName": "1001",
"taxType": "PPT",
"personalTaxId": "36570630563",
"type": "pseco",
"telephoneNumber": "575555555555"
},
"productDetail": "ljwtest",
"productName": "WEWQ",
"reference": "ljw1769658309659",
"returnUrl": "https://www.baidu.com/",
"shopperReference": "LLL3211321",
"webhookUrl": "https://develop.futureshop.global/api/checkout/payment/123"
}参数名 类型 必填 说明 codeString 是 响应状态码，"0" 表示成功 msgString 是 响应消息 serverTimeNumber 是 服务器时间戳，单位毫秒 dataObject 是 业务数据对象 ├── action Object 是 支付跳转相关信息 │ ├── paymentMethodType String 是 支付方式类型（如 alipaycn） │ ├── url String 是 Web 端支付 URL │ ├── method String 是 请求方法（如 Get） │ ├── type String 是 操作类型（如 redirect） ├── amount Object 是 订单金额信息 │ ├── currency String 是 货币类型（如 HKD, USD） │ ├── value Number 是 金额数值，单位为最小货币单位 ├── merchantReference String 是 商户订单号 ├── pspReference String 是 支付平台交易号 ├── resultCode String 是 支付结果状态（如 PENDING） successBoolean 是 是否成功（true 表示成功）
JSON
{
"code": "0",
"data": {
"action": {
"method": "Get",
"paymentMethodType": "pseco",
"type": "redirect",
"url": "https://registro.pse.com.co/PSENF/index.html?enc=bxuZ5%2bP%2fm%2fvXumvF%2bXvTIhaSkQ1xJ17s8kvAwRTEgew%3d"
},
"amount": {
"currency": "COP",
"value": 1000
},
"merchantReference": "ljw1769658309659",
"providerReference": "mm_AxQcJ3uSfyHKiH",
"pspReference": "2016719246700183552",
"resultCode": "PENDING"
},
"msg": "success",
"serverTime": 1769658347276,
"success": true
}字段名称 类型 必填 示例值 可选值 bankName String M 如:"1001" 银行代码 (bankName) 详细列表见下方表格
银行代码(bankName) 银行名称(bankNameDesc) 1001 Banco de Bogota 1002 Banco Popular 1006 Itau 1007 Bancolombia 1009 Citibank 1012 Banco GNB Sudameris 1013 BBVA Colombia 1019 Scotiabank Colpatria 1023 Banco de Occidente 1032 Banco Caja Social 1040 Banco Agrario 1047 Banco Mundo Mujer 1051 Banco Davivienda 1052 Banco AV Villas 1059 Bancamia 1060 Banco Pichincha 1061 Bancomfa 1062 Banco Falabella 1063 Banco Finandina 1065 Banco Santander de Negocios Colombia 1066 Banco Cooperativo Coopcentral 1069 Banco Serfinanza 1070 Lulo Bank 1071 Banco JP Morgan Colombia 1097 Dale 1121 Financiera Juriscoop 1283 Cooperativa Financiera de Antioquia 1286 JFK Cooperativa Financiera 1289 Cotrafa Cooperativa Financiera 1292 Confiar Cooperativa Financiera 1303 Banco Union 1370 Coltefinanciera 1507 Nequi 1551 Daviplata 1558 BAN100 S.A 1801 Movii 1802 Ding Tecnopagos 1804 Uala 1808 Bold CF 1809 Nu Colombia 1811 RappiPay 1812 COINK 1814 Global66 1815 Alianza Fiduciaria 1816 Crezcamos
字段名称 类型 必填 示例值 可选值 taxType String M 如:"CC" 详细列表见下方表格
Label（证件名称） Value（代码） Permiso de residencia PPT Cédula de ciudadanía CC Cédula de Extranjería CE Número de Identificación Tributaria NIT Passport PA Tarjeta de identidad TI Tarjeta de extranjería TE Documento de Identificación Extranjero DIE Registro Civil RC
