支付方式属性

属性	值
消费者货币	英镑（GBP）
处理货币	英镑（GBP）
类型 I	银行转账 (bankTransfer)
类型 II	`gbbanktransferva`
最低交易金额	GBP 0.5
最高交易金额	GBP 999999.99
会话超时	取决于流程
退款	不支持退款
退款有效期	-
拒付	否
集成类型	异步

交易流程

商户先调用「创建客户」接口完成客户认证，获取唯一 customerId。
客户下单时传入customerId。首次调用银行转账收款，Future Pay 根据 customerId 查询客户信息并为其开立专属虚拟收款账户（VA），VA账户信息通过Webhook回调通知商户。
客户确认应付金额，以及转账银行账户信息。
客户主动汇款，向专属收款账户转入对应金额。
Future Pay 到账后向商户发送交易结果通知。

集成

请求参数说明

参数名	类型	必填	说明
`reference`	String	是	订单唯一标识
`amount`	Object	是	订单金额信息
├── `currency`	String	是	货币类型（如 GBP）
├── `value`	Number	是	金额数值，单位为最小货币单位
`productDetail`	String	是	订单描述
`countryCode`	String	是	国家代码（如 GB）
`origin`	String	是	订单来源，如商城域名
`paymentMethod`	Object	是	支付方式信息
├── `holderName`	String	否	持卡人姓名
├── `shopperEmail`	String	否	付款人邮箱
├── `type`	String	是	支付方式（如 gbbanktransferva）
`returnUrl`	String	是	支付完成后返回的 URL
`statementDescriptor`	String	否	收款账户持卡人姓名
`browserInfo`	Object	否	设备浏览器信息（如不指定该信息，则会获取userAgent信息判断消费者终端信息）
├── `osType`	String	否	操作系统类型（如 IOS, ANDROID,OTHER）
├── `terminalType`	String	否	终端类型（如 APP, WAP,WEB,MINI_APP）
`shopperReference`	String	是	付款人唯一标识 ⚠️注意：此处需要传递创建客户返回的customerId
`webhookUrl`	String	否	回调通知地址
`billingAddress`	Object	否	账单地址
├── `city`	String	否	城市
├── `country`	String	否	国家
├── `street`	String	否	街道
├── `postalCode`	String	否	邮编
├── `stateOrProvince`	String	否	州/省

交易调用输入示例

{
    "reference": "TR1739188526ANM7D7",
    "amount": {
        "currency": "GBP",
        "value": 10000
    },
    "productDetail": "描述订单",
    "countryCode": "GB",
    "origin": "fffmall.com",
    "paymentMethod": {
        "holderName": "test",
        "shopperEmail": "[email protected]",
        "type": "gbbanktransferva"
    },
    "statementDescriptor": "ABC Co., Ltd.",
    "returnUrl": "https://www.baidu.com",
    "browserInfo": {
        "osType": "IOS",
        "terminalType": "APP"
    },
    "billingAddress": {
        "city": "San Francisco",
        "country": "US",
        "street": "1234 Market Street, Suite 500",
        "postalCode": "94103",
        "stateOrProvince": "California"
    },
    "shopperReference": "FPeb01fb2a448143c1b1d944062c9d9153"
}

响应参数说明

参数名	类型	说明
`code`	String	响应状态码，"0" 表示成功
`msg`	String	响应消息
`serverTime`	Number	服务器时间戳，单位毫秒
`data`	Object	业务数据对象
├── `amount`	Object	订单金额信息
│ ├── `currency`	String	货币类型（如 GBP）
│ ├── `value`	Number	金额数值，单位为最小货币单位
├── `merchantReference`	String	商户订单号
├── `pspReference`	String	支付平台交易号
├── `resultCode`	String	支付结果状态（如 PENDING）
├── `order`	Object	账户信息
│ ├──`bank`	String	银行名称
│ ├──`iban`	String	银行账户号码
│ ├──`accountHolderName`	String	账户持卡人姓名
│ ├──`bankAddress`	String	银行地址
│ ├──`bic`	String	BIC
│ ├──`swiftCode`	String	SwiftCode
│ ├──`country`	String	国家/地区
`success`	Boolean	是否成功（true 表示成功）

{
    "code": "0",
    "msg": "success",
    "serverTime": 1787038514901,
    "data": {
        "amount": {
            "currency": "GBP",
            "value": 50000
        },
        "merchantReference": "202608018-415",
        "order": {
            "iban": "GB83SMLT04050900124772",
            "accountHolderName": "ZHANG XIAO WEI",
            "swiftCode": "SEOUGB21",
            "bankAddress": "The Bower, 207-211 Old Street, London, England, EC1V 9NR",
            "bic": "SEOUGB21",
            "country": "GB"
        },
        "pspReference": "2089617100476907520",
        "resultCode": "PENDING"
    },
    "success": true
}

虚拟账户通知

当第一次下单时，不会有order字段（虚拟账户信息）。后续会通过商户端配置的 Webhook 路径通知生成的虚拟银行账户信息。

Webhook回调请求参数：

{
    "merchantId": "2076614224058167296",
    "appId": "2076614224167198720",
    "notificationItems": [
        {
            "eventCode": "VA_ACTIVATED",
            "eventDate": 1787044546179,
            "iban": "GB66SMLT04050900124787",
            "accountHolderName": "SONG MAO",
            "bank": "Simulator Bank",
            "bankAddress": "The Bower, 207-211 Old Street, London, England, EC1V 9NR",
            "country": "GB",
            "currency": "GBP",
            "customerId": "FP75c9ac0f256a404085ad5a1e4dddf818",
            "sortCode": "040509",
            "bic": "SEOUGB21",
            "swiftCode": "SEOUGB21",
            "status": "Success",
            "remark": "Account activated successfully",
        }
    ]
}