支付方式属性

属性	值
消费者货币	阿联酋迪拉姆（AED）
处理货币	阿联酋迪拉姆（AED）
类型 I	银行转账 (bankTransfer)
类型 II	`aebanktransferva`
最低交易金额	AED 0.5
最高交易金额	AED 999999.99
会话超时	取决于流程
退款	不支持退款
退款有效期	-
拒付	支持线下拒付
集成类型	异步

交易流程

商户联系 Future Pay 开通商户级账户。账户按收单账户（主账户、子账户）分别开立，开立结果通过 Webhook 通知商户，也可调用「查询虚拟银行卡信息」接口查询。
客户下单时，paymentMethod.subType 传 MERCHANT，无需传 customerId。Future Pay 返回商户级账户信息和本笔订单的附言（order.reference）。
商户向客户展示收款账户、应付金额和附言。
客户转账时在附言（Reference）中填写该附言，并按订单金额全额转账。
Future Pay 到账后按附言匹配订单，并向商户发送交易结果通知。附言或金额对不上时的处理见下方「到账处理规则」。

⚠️
商户级账户注意事项：

每笔订单的附言都不同，不能复用。附言不区分大小写，前后可带其他文字，但字符不能写错（如数字 0 写成字母 O），写错按「附言无法匹配」处理。

请让客户按订单金额全额转账。

附言只能转入下单时返回的那个账户。商户有多个收单账户时，下单和查询时在请求头传 subAccountNo 指定收单账户；不传则使用默认账户。

同一个 merchantReference 可能收到多条交易成功通知（见下方「到账处理规则」），请以 pspReference 区分订单。

到账处理规则

到账情况	处理方式	交易结果通知
附言正确，金额与订单一致	原订单置为成功	`merchantReference` 为原订单号
附言正确，但金额与订单不一致，或订单已支付后再次转账	按实际到账金额新建一笔订单并置为成功（补单），原订单状态不变	`merchantReference` 为原订单号，`pspReference` 为新订单号，`amount` 为实际到账金额
未填写附言，或附言无法对应到该账户的订单	按实际到账金额，在该收单账户下新建一笔订单并置为成功	`merchantReference` 为系统生成的订单号，`pspReference` 为新订单号

收到 merchantReference 不是自己订单号的成功通知，即为附言无法匹配的到账，请携带 pspReference 联系 Future Pay 核对付款人信息。

集成

请求参数说明

参数名	类型	必填	说明
`reference`	String	是	订单唯一标识
`amount`	Object	是	订单金额信息
├── `currency`	String	是	货币类型（如 AED）
├── `value`	Number	是	金额数值，单位为最小货币单位
`productDetail`	String	是	订单描述
`countryCode`	String	是	国家代码（如 AE）
`origin`	String	是	订单来源，如商城域名
`paymentMethod`	Object	是	支付方式信息
├── `holderName`	String	否	持卡人姓名
├── `shopperEmail`	String	否	付款人邮箱
├── `type`	String	是	支付方式（如 aebanktransferva）
├── `subType`	String	否	账户类型：传 `MERCHANT` 使用商户级账户，不传使用消费者级账户（区分大小写）
`returnUrl`	String	是	支付完成后返回的 URL
`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": "TR1739188526ANM7D8",
    "amount": {
        "currency": "AED",
        "value": 10000
    },
    "productDetail": "描述订单",
    "countryCode": "AE",
    "origin": "fffmall.com",
    "paymentMethod": {
        "type": "aebanktransferva",
        "subType": "MERCHANT"
    },
    "returnUrl": "https://www.baidu.com"
}

响应参数说明

参数名	类型	说明
`code`	String	响应状态码，"0" 表示成功
`msg`	String	响应消息
`serverTime`	Number	服务器时间戳，单位毫秒
`data`	Object	业务数据对象
├── `amount`	Object	订单金额信息
│ ├── `currency`	String	货币类型（如 EUR）
│ ├── `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	国家/地区
│ ├──`reference`	String	附言（仅商户级账户返回），客户转账时必须填写
`success`	Boolean	是否成功（true 表示成功）

{
    "code": "0",
    "msg": "success",
    "serverTime": 1792981072858,
    "data": {
        "amount": {
            "currency": "AED",
            "value": 29900
        },
        "merchantReference": "220261026101",
        "order": {
            "reference": "FP1TP2WQN504000",
            "bank": "Zand Bank PJSC",
            "accountHolderName": "ndht",
            "swiftCode": "ZANDAEAAXXX",
            "bankAddress": "1st floor, Emaar square, Bulding 6, Dubai,United Arab Emirates",
            "bic": "ZANDAEAAXXX",
            "iban": "AE426406718620474656659",
            "country": "AE"
        },
        "pspReference": "2114541992179531776",
        "resultCode": "PENDING",
        "providerReference": "FP1TP2WQN504000"
    },
    "success": true
}

虚拟账户通知

商户级账户：Future Pay 为商户开立商户级账户后，同样通过 Webhook 发送 VA_ACTIVATED 通知。通知中不含 customerId，增加字段：

字段	说明
`subType`	固定为 `MERCHANT`，表示商户级账户

Webhook回调请求参数（商户级账户）：

{
    "merchantId": "2076614224058167296",
    "appId": "2076614224167198720",
    "notificationItems": [
        {
            "eventCode": "VA_ACTIVATED",
            "eventDate": 1787045003061,
            "subType": "MERCHANT",
            "subAccountNo": "ACC001",
            "iban": "AE840994388038695202167",
            "accountHolderName": "jjww",
            "bank": "Zand Bank PJSC",
            "bankAddress": "1st floor, Emaar square, Bulding 6, Dubai,United Arab Emirates",
            "country": "AE",
            "currency": "AED",
            "bic": "ZANDAEAAXXX",
            "swiftCode": "ZANDAEAAXXX",
            "status": "SUCCESS",
            "remark": "Account activated successfully"
        }
    ]
}

status 取值：

SUCCESS（开户成功）

FAILED（开户失败）

CLOSED（关户）

RFI（待补充材料）