参数对象说明(过期）
参数对象说明(过期)
参数对象说明
公共参数说明
userInfo
用户信息
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| userId | N | string | max=128 用户id |
| ip | Y | string | max=128 IPv4或IPv6 |
| Y | string | max=128用户邮箱 | |
| phoneNo | N | string | max=32 用户手机号 |
payerInfo
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| paymentMethod | Y | string | 目前固定为 credit_card |
| authorizationMethod | Y | string |
当客户的卡 需要3ds时我们会动态转成3d。 只是对接测试的时候 可以根据自己需要的场景切换 cvv/threeds2.0。 threeds1.0现在我们不支持传，3d一般都走2.0流程,即使客户的卡只支持1.0， 我们也会自动降级的 |
| billingAddress | Y | Json String | 账单地址 |
| firstName | N | String(56) | 持卡人名（如果为空，则UseePay会用账单/收货地址姓名填充） |
| lastName | N | String(56) | 持卡人名（如果为空，则UseePay会用账单/收货地址姓名填充） |
billingAddress
账单地址信息
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Y | string | 收货邮箱 | |
| firstName | Y | string | 收货人名 |
| lastName | Y | string | 收货人姓 |
| phoneNo | N | string | 收货手机号 |
| street | Y | string | 收货街道地址 |
| houseNo | N | string | 收货街道地址和门牌号当street存在时可以不填 |
| postalCode | Y | string | 邮编，如果该国家或地区由邮编必须传，否则可以不传 |
| city | Y | string | 城市 |
| state | Y | string | 省/州/ 地区, 需满足 ISO 3166-2 |
| country | Y | string | 国家，ISO 两位大写英文国家代码, 需满足 ISO 3166-1 |
orderInfo
订单信息
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| subject | Y | string | 订单标题 |
| goodsInfo | Y | array | 商品信息, 请参考 goodsInfo |
| shippingAddress | Y | object | 收货地址, 请参考 shippingAddress |
goodsInfo
商品信息
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| id | Y | string | sku id |
| name | Y | string | 商品名 |
| body | Y | string | 商品描述 |
| quantity | Y | number | 商品数量 |
| price | Y | string | 商品价格,必须大于0，单位为对应货币的最小 货币单位参考货币单位一节 |
| url | N | string | 商品链接 |
| image | N | string | 商品图片 |
shippingAddress
收货地址
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| Y | string | 收货邮箱 | |
| phoneNo | N | string | 收货手机号 |
| firstName | Y | string | 收货人名 |
| lastName | Y | string | 收货人姓 |
| street | Y | string | 收货街道地址 |
| houseNo | N | string | 收货街道地址和门牌号当street存在时可以不填 |
| postalCode | Y | string | 邮编，如果该国家或地区由邮编必须传，否则可以不传 |
| city | N | string | 城市 |
| state | Y | string | 省/州/地区, 需满足 ISO 3166-2 |
| country | Y | string | 国家，ISO 两位大写英文国家代码, 需满足 ISO 3166-1 |
修改于 2025-08-22 03:28:24