先买后付
Antom 计划添加一些支持先买后付(BNPL)功能的支付方式。BNPL 是一种分期贷款,为买家提供长期有效且可循环的信用额度。买家可以使用这个信用额度进行交易。然而,支付方式仍需对 BNPL 交易实施实时风险控制,以降低买家和支付方式双方的风险,这要求商家在向 Antom 发起接口请求时提供特定信息。这些信息分为基本信息和扩展信息,对支付的成功与否有很大影响。
对商户的要求
对于 支付(收银台)接口请求,需要特定的参数。请参阅以下部分了解详情。
基本信息参数
以下表格中的参数强烈建议由商户提供。支付方式的风险控制很大程度上依赖于这些参数。如果提供这些参数,预计支付成功率可提升 5%~10%。
类别 | 参数 | 描述 |
order.buyer | referenceBuyerId | 可选 字符串 (64) 商家为识别买家所分配的专属 ID。 |
order.goods | goodsName | 可选 字符串 (256) 商品名称。 |
order.shipping | shippingAddress | 可选 地址 收件人的送货地址。详见 shippingAddress。 |
表 1. 基本信息参数
shippingAddress
字段 | 描述 |
region | 必填 字符串 (2) 两位字符的 ISO 3166 国家/地区代码。 |
state | 可选 字符串 (8) 州、国家或省份。 |
city | 可选 字符串 (32) 城市、区、郊区、城镇或村庄。 |
address1 | 可选 字符串 (256) 地址行 1,如街道、邮政信箱或公司名称。 |
address2 | 可选 字符串 (256) 地址行 2,如公寓、套房、单元或建筑信息。 |
zipCode | 可选 字符串 (32) 邮政编码 |
表 2. shippingAddress 参数
扩展信息参数
以下表格中的参数建议由商户传递。 如果提供这些参数, 预计支付成功率可提升约 5%。
类别 | 参数 | 描述 |
order.goods | referenceGoodsId | 必需 字符串 (64) 商家为识别商品分配的专属ID。 |
goodsCategory | 可选 字符串 (64) 商品类型的分类。 | |
goodsUnitAmount | 必填 金额 商品价格。详情参见 goodsUnitAmount。 | |
goodsQuantity | 必填 整数 商品数量。 |
表 3. 扩展信息参数
goodsUnitAmount
字段 | 描述 |
currency | 必填 字符串 (3 位) 三位字符的 ISO-4217 货币代码。 |
value | 必填 整数 以最小币种单位的正整数形式表示的金额值。例如,如果币种是 值范围:1 - 无限。 |
表 4. goodsUnitAmount 参数