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 bancolombiaco会话超时 30分钟 退款 不支持退款 拒付 无 集成类型 异步
消费者在商家的结账页面选择BANCOLOMBIA付款并填写个人信息。
消费者被重定向银行支付信息页面。
消费者在网上银行完成支付。
消费者完成交易。
消费者被重定向对应页面。
参数名 类型 必填 说明 referenceString 是 订单唯一标识 amountObject 是 订单金额信息 ├── currency String 是 货币类型(如 COP) ├── value Number 是 金额数值,单位为最小货币单位 productDetailString 是 订单描述 countryCodeString 是 国家代码(如 CO) originString 是 订单来源,如商城域名 paymentMethodObject 是 支付方式信息 ├── shopperEmail String 是 付款人邮箱 ├── type String 是 支付方式(如 bancolombiaco) ├── telephoneNumber String 是 电话号码 ├── holderName String 是 姓名 ├── taxType String 是 身份类型 ├── personalTaxId String 是 对应身份类型号码 returnUrlString 是 支付完成后返回的 URL shopperReferenceString 是 付款人唯一标识
JSON
{
"amount": {
"currency": "COP",
"value": 1000
},
"countryCode": "CO",
"origin": "fffmall.com",
"paymentMethod": {
"shopperEmail": "[email protected] ",
"holderName": "JW L",
"taxType": "PPT",
"personalTaxId": "36570630563",
"type": "bancolombiaco",
"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": "bancolombiaco",
"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
}
字段名称 类型 必填 示例值 可选值 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