支付方式属性

属性	值
适用国家代码	US（美国）、CA（加拿大）
消费者货币	美元（USD）、加拿大元（CAD）
处理货币	美元（USD）、加拿大元（CAD）
类型 I	先买后付（buyNowPayLater）
类型 II	`affirm`
最低交易金额	USD 50、CAD 50
最高交易金额	USD 30000、CAD 30000
会话超时	3 分钟至 12 小时，取决于流程
退款	支持全额、部分和多次部分退款
退款有效期	120天
拒付	是
集成类型	异步

交易流程

消费者在商家的结账页面选择 affirm。
消费者选择 affirm 支付，Future Pay发送交易请求到 affirm 平台。
用户的浏览器将会重定向到 affirm 的专属授权页面。
用户在 affirm 页面上登录、校验手机号。
affirm 实时评估信用，向用户展示可用的分期方案。用户选择方案并确认付款。
用户在 affirm 确认完毕后，向 Future Pay 发送确认通知。
Future Pay 向商家发送交易结果通知。消费者返回商家结账页面，看到确认消息后可以继续购物。

集成

请求参数说明

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

交易调用输入示例

{
    "reference": "TR1739188526ANM7D7",
    "amount": {
        "currency": "USD",
        "value": 5100
    },
    "productDetail": "描述订单",
    "countryCode": "US",
    "origin": "fffmall.com",
    "paymentMethod": {
        "holderName": "test",
        "shopperEmail": "[email protected]",
        "type": "affirm"
    },
    "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": "8cc77a71707447819ef87155926516cc"
}

响应参数说明

参数名	类型	必填	说明
`code`	String	是	响应状态码，"0" 表示成功
`msg`	String	是	响应消息
`serverTime`	Number	是	服务器时间戳，单位毫秒
`data`	Object	是	业务数据对象
├── `action`	Object	是	支付跳转相关信息
│ ├── `paymentMethodType`	String	是	支付方式类型（如 affirm）
│ ├── `url`	String	是	Web 端支付 URL
│ ├── `method`	String	是	请求方法（如 Get）
│ ├── `type`	String	是	操作类型（如 redirect）
├── `amount`	Object	是	订单金额信息
│ ├── `currency`	String	是	货币类型（如 USD）
│ ├── `value`	Number	是	金额数值，单位为最小货币单位
├── `merchantReference`	String	是	商户订单号
├── `pspReference`	String	是	支付平台交易号
├── `resultCode`	String	是	支付结果状态（如 PENDING）
`success`	Boolean	是	是否成功（true 表示成功）

交易调用输出示例

{
    "code": "0",
    "msg": "success",
    "serverTime": 1783594292375,
    "data": {
        "action": {
            "paymentMethodType": "affirm",
            "url": "https://r2.girogate.de/molpay/S1389/I?tx=2334590813&rs=ZMQklSaGdmdZw9NTiM16xen8591YbjuY&cs=e1f62ec550918e3471308d9e34a830e3d7f22dc40690616190a9c16d8f653049",
            "method": "Get",
            "type": "redirect"
        },
        "amount": {
            "currency": "USD",
            "value": 5100
        },
        "merchantReference": "TR1739188526ANM7D7",
        "pspReference": "2075170980153655296",
        "resultCode": "PENDING"
    },
    "success": true
}