扫码支付 Server To Server模式

POST/api

时序图

sequenceDiagram
Consumer->>Merchant: 点击支付
Merchant->>UseePay Server: 请求/api 接口
UseePay Server-)Merchant: response[codeUrl(二维码地址)]
Merchant->>Consumer: 把codeUrl转成二维码并展示
Consumer->>Wechat Server: 手机扫码支付
Wechat Server-->> UseePay Server: 异步通知支付结果
UseePay Server-->> Merchant: 异步通知支付结果

请求参数对象说明

payerInfo

参数	类型	说明	是否必填
paymentMethod	string	固定值 wechat_native	Y
authorizationMethod	string	固定值 cvv	Y
billingAddress	string(string)	账单地址	N

orderInfo

参数	类型	说明	是否必填
subject	String（128）	订单标题，可以是商品名称。这个最终会提现在微信支付账单中	Y
goodsInfo	string(json array)	商品详细新下	N
shippingAddress	string(json)	账单地址	N

userInfo

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/x-www-form-urlencoded

Body 参数application/x-www-form-urlencoded

amount

string

必需

订单金额，必须大于0. 参考金额和货币单位

示例值:

123

appId

string

网站域名(128)

必需

示例值:

www.pay.com

currency

string

必需

币种: 3 位 ISO 金额和货币单位

示例值:

USD

echoParam

string

可选

回声参数，响应报文会原样返回(256)

示例值:

echoParam

merchantNo

string

必需

商户号: (max=16)

示例值:

500000000007362

notifyUrl

string

必需

异步通知地址(max=512)

示例值:

https://gatewaytest.useepay.com/gateway-test/notifyV2u0

orderInfo

string

可选

json string, 订单信息, 请参考下方

示例值:

{\"shippingAddress\":{\"email\":\"amber.lei@useepay.com\",\"phoneNo\":\"123\",\"firstName\":\"amber\",\"lastName\":\"lei\",\"street\":\"118 trenton drive\",\"postalCode\":\"37830\",\"city\":\"city\",\"state\":\"Tennessee\",\"country\":\"US\"},\"subject\":\"订单标题\",\"goodsInfo\":[{\"id\":\"商品编号\",\"name\":\"商品名称\",\"body\":\"商品描述\",\"category\":\"商品类目\",\"categoryTree\":\"商品类目树，不同级别类目使用”|”分割\",\"brand\":\"商品品牌\",\"quantity\":1,\"price\":1234,\"url\":\"商品url\",\"sku\":\"商品sku\",\"image\":\"商品图片url\"}]}

payerInfo

string

必需

Json格式的String 付款方信息, 请下方

示例值:

{\"paymentMethod\":\"wechat_native\",\"authorizationMethod\":\"cvv\",\"firstName\":\"amber\",\"lastName\":\"lei\",\"billingAddress\":{\"houseNo\":\"El Gallo Giro(https://gallogiro.com/)\",\"email\":\"amber.lei@useepay.com\",\"phoneNo\":\"1235854433\",\"firstName\":\"amber\",\"lastName\":\"Yang\",\"stlogreet\":\"7148 Pacific Blvd, Huntington Park, CA\",\"postalCode\":\"90225\",\"city\":\"Huntington Park\",\"state\":\"CA\",\"country\":\"MX\",\"street\":\"street\"}}

redirectUrl

string

可选

同步通知地址(max=512)

示例值:

http://192.168.1.56:8003/redirectV2u0

signType

string

必需

签名类型: MD5/RSA

示例值:

MD5

transactionExpirationTime

string

可选

过期时间: 单位分钟 1-120

示例值:

120

transactionId

string

必需

商户订单号: max(64)

示例值:

202212070142347

transactionType

string

必需

交易类型 : pay

示例值:

pay

userInfo

string

必需

json string, 消费者信息, 请参考消费者信息

示例值:

{\"ip\":\"127.0.0.1\",\"email\":\"amber.lei@useepay.com\"}

sign

string

签名

必需

示例值:

6c17d0a6131a35229e8c05b8cff2aae1

version

string

必需

目前固定为 1.0 (5)

示例值:

1.0

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

codeUrl

string

二维码链接

可选

需要转成二维码使用, resultCode = pending时返回

amount

string

订单金额

必需

订单金额，必须大于0. 参考金额和货币单位

redirectUrl

string

同步通知地址

可选

异步通知地址 resultCode = pending 适合

resultCode

string

业务结果码

必需

参考业务结果码

sign

string

签名值

必需

errorCode

string

错误码

可选

详见错误码 errorCode

transactionId

string

商户订单号

必需

max(64)

errorMsg

string

错误码信息描述

可选

用于展示给消费者具体的错误信息

transactionType

string

交易状态

必需

固定 pay

reference

string

交易流水号

可选

UseePay返回的交易流水号

echoParam

string

回声参数

可选

同Request参数原样返回 (max=256)

signType

string

签名类型

必需

currency

string

币种

必需

merchantNo

string

商户号

必需

商户号(max=16)

{
  "codeUrl": "weixin://wxpay/bizpayurl?pr=lHmpT1Mzz",
  "amount": "100",
  "redirectUrl": "http://192.168.1.56:8003/redirectV2u0",
  "resultCode": "pending",
  "sign": "5c5b84597a7db7674c108fbe43305dbf",
  "errorCode": "3200",
  "transactionId": "202305260343367",
  "errorMsg": "Transaction is pending",
  "transactionType": "pay",
  "reference": "1012305261543015506",
  "echoParam": "echoParam",
  "signType": "MD5",
  "currency": "USD",
  "merchantNo": "500000000007245"
}

最后修改时间： 2 个月前