1. userInfo

用户信息

参数	必选	类型	说明
userId	N	string	max=128 用户id
ip	Y	string	max=128 IPv4或IPv6
email	Y	string	max=128用户邮箱
phoneNo	N	string	max=32 用户手机号

2. payerInfo

参数	必选	类型	说明
paymentMethod	Y	string	目前固定为 credit_card
authorizationMethod	Y	string	cvv （普通交易） threeds2.0 (3D) AuthorizationMethod（用户授权方式：cvv/threeds1.0/threeds2.0）：这个字段生产环境传cvv，当客户的卡需要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

订单信息（String）

参数	必选	类型	说明
subject	Y	string	订单标题
goodsInfo	Y	array	商品信息, 请参考 goodsInfo
shippingAddress	Y	object	收货地址, 请参考 shippingAddress

orderInfo样例：

"orderInfo"="{"subject":"order title","goodsInfo":[{"id":"商品编号","name":"商品名称","body":"商品描述","category":"商品类目","categoryTree":"商品类目树，不同级别类目使用”|”分割","brand":"商品品牌","quantity":1,"price":1234,"url":"商品url","sku":"商品sku","image":"商品图片url"}],"shippingAddress":{"email":"haile1y@useepay.com","phoneNo":"123123","firstName":"Victor","lastName":"Yang","street":"Heathcoat House, 20 Savile Row","postalCode":"W1S 3PR","city":"London","state":"LND","country":"GB"}}"

美观输出：

{
  "subject": "order title",
  "goodsInfo": [
    {
      "id": "商品编号",
      "name": "商品名称",
      "body": "商品描述",
      "category": "商品类目",
      "categoryTree": "商品类目树，不同级别类目使用”|”分割",
      "brand": "商品品牌",
      "quantity": 1,
      "price": 1234,
      "url": "商品url",
      "sku": "商品sku",
      "image": "商品图片url"
    }
  ],
  "shippingAddress": {
    "email": "haile1y@useepay.com",
    "phoneNo": "123123",
    "firstName": "Victor",
    "lastNaame": "Yang",
    "street": "Heathcoat House, 20 Savile Row",
    "postalCode": "W1S 3PR",
    "city": "London",
    "state": "LND",
    "country": "GB"
  }
}

3.1 goodsinfo

数组，保存商品信息
注意尽量避免对象长度不超过15000字符

参数	必选	类型	说明
id	Y	string	sku id
name	Y	string	商品名
body	Y	string	商品描述
quantity	Y	number	商品数量
price	Y	string	商品价格,必须大于0，单位为对应货币的最小货币单位参考货币单位一节
url	N	string	商品链接
image	N	string	商品图片

样例（美观输出）：

  "goodsInfo": [
    {
      "id": "商品编号1",
      "name": "商品名称1",
      "body": "商品描述1",
      "category": "商品类目1",
      "categoryTree": "商品类目树，不同级别类目使用”|”分割",
      "brand": "商品品牌1",
      "quantity": 1,
      "price": 1234,
      "url": "商品url",
      "sku": "商品sku",
      "image": "商品图片url"
    },
    {
      "id": "商品编号2",
      "name": "商品名称2",
      "body": "商品描述2",
      "category": "商品类目2",
      "categoryTree": "商品类目树，不同级别类目使用”|”分割",
      "brand": "商品品牌2",
      "quantity": 1,
      "price": 1234,
      "url": "商品url",
      "sku": "商品sku",
      "image": "商品图片url"
    }
  ]

3.2 shippingAddress

实物类交易必传，虚拟类交易非必传

参数	是否必传	类型	说明
email	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

账单地址信息

4.1 billingAddress（实物类交易）

参数	必选	类型	说明
email	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

4.1 billingAddress（虚拟类交易）

参数	必选	类型	说明
email	Y	string	买家邮箱
firstName	N	string	收货人名
lastName	N	string	收货人姓
phoneNo	N	string	收货手机号
street	N	string	收货街道地址
houseNo	N	string	收货街道地址和门牌号当street存在时可以不填
postalCode	N	string	邮编，如果该国家或地区由邮编必须传，否则可以不传
city	N	string	城市
state	N	string	省/州/地区, 需满足 ISO 3166-2
country	N	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

对象模型

1. userInfo#

2. payerInfo#

3. orderInfo#

3.1 goodsinfo#

3.2 shippingAddress#

4. billingAddress#

4.1 billingAddress（实物类交易）#

4.1 billingAddress（虚拟类交易）#

5. deviceInfo#

6. transactionInfo#

1. userInfo

2. payerInfo

3. orderInfo

3.1 goodsinfo

3.2 shippingAddress

4. billingAddress

4.1 billingAddress（实物类交易）

4.1 billingAddress（虚拟类交易）

5. deviceInfo

6. transactionInfo