对象模型
1. userInfo
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| userId | N | string | max=128 用户id |
| ip | Y | string | max=128 IPv4或IPv6 |
| Y | string | max=128用户邮箱 | |
| phoneNo | N | string | max=32 用户手机号 |
2. 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会用账单/收货地址姓名填充） |
3. orderInfo
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| subject | Y | string | 订单标题 |
| goodsInfo | Y | array | 商品信息, 请参考 goodsInfo |
| shippingAddress | Y | object | 收货地址, 请参考 shippingAddress |
3.1 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 | 商品图片 |
3.2 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 |
4. 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 |
5. deviceInfo
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| fingerPrintId | N | string | max=128 设备指纹 ID |
| mac | N | string | max=64 用交易设备 mac 地址 |
| osType | N | string | max=16 ios/ android |
6. transactionInfo
| 参数 | 描述 | 是否必须 |
|---|---|---|
| transactionId | max=64商户订单号 | true |
| originalTransactionId | max=64 原始商户订单号 | |
| reference | max=32USEEPAY 订单号 | false |
| transactionType | max=64 pay； authorization; refund; capture;authorizationVoid; | true |
| amount | max=12交易金额，单位为对应币种的最小货币单位(详见 ISO 4217) | false |
| currency | max=33 位 ISO 大写字母货币代码(详见 ISO 4217) | false |
| resultCode | max=32业务结果（详见 业务结果码） | true |
| errorCode | max=4错误码（详见 错误码 errorCode） | false |
| errorMsg | max=256错误码消息描述 | false |
修改于 2025-08-22 03:28:24