USEEPAY

H5支付

全球收单-SandBox环境

https://pay-gateway1.uat.useepay.com

POST

/cashier

wechatH5

请求参数

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

amount

string

必需

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

示例值:

100

appId

string

网站域名(128)

必需

示例值:

www.pay.com

autoRedirect

string

可选

是否302跳转，默认 true true/ false

示例值:

false

currency

string

必需

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

示例值:

HKD

echoParam

string

可选

回声参数，Response 中将会原样返回 (max=256)

示例值:

echoParam

gatewaySource

string

可选

数据来源 1. useepay 2. shoplazza 3. shopline 如有新增，请联系UseePay

示例值:

useepay

merchantNo

string

必需

商户号(max=16)

示例值:

500000000007245

notifyUrl

string

可选

异步通知地址(max=512)

示例值:

https://gatewaytest.useepay.com/notifyV2u0

orderInfo

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

付款人信息

必需

示例值:

{"paymentMethod":"wechat_h5","authorizationMethod":"cvv","firstName":"amber","lastName":"lei","billingAddress":{"houseNo":"102","email":"amber.lei@useepay.com","phoneNo":"1235854433","firstName":"amber","lastName":"lei","stlogreet":"7148 Pacific Blvd, Huntington Park, CA","postalCode":"90225","city":"Huntington Park","state":"CA","country":"MX","street":"street"}}

redirectUrl

string

同步通知地址

必需

示例值:

http://192.168.1.56:8003/redirectV2u0

sign

string

必需

签名值: 验证请求是否被串改

示例值:

505f3091cb56e5569b9c74e2767000cc

signType

string

必需

签名类型: MD5/RSA

示例值:

MD5

terminalType

string

必需

终端类型： WEB / H5

示例值:

WEB

transactionExpirationTime

string

必需

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

示例值:

120

transactionId

string

可选

商户订单号: max(64)

示例值:

202305260151415

transactionType

string

必需

交易类型: 固定值 pay

示例值:

pay

userInfo

string

必需

用户信息：字符串类型的JSON格式

示例值:

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

version

string

版本固定1.0

必需

示例值:

1.0

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://pay-gateway1.uat.useepay.com/cashier' \
--data-urlencode 'amount=100' \
--data-urlencode 'appId=www.pay.com' \
--data-urlencode 'autoRedirect=false' \
--data-urlencode 'currency=HKD' \
--data-urlencode 'echoParam=echoParam' \
--data-urlencode 'gatewaySource=useepay' \
--data-urlencode 'merchantNo=500000000007245' \
--data-urlencode 'notifyUrl=https://gatewaytest.useepay.com/notifyV2u0' \
--data-urlencode 'orderInfo={"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"}]}' \
--data-urlencode 'payerInfo={"paymentMethod":"wechat_h5","authorizationMethod":"cvv","firstName":"amber","lastName":"lei","billingAddress":{"houseNo":"102","email":"amber.lei@useepay.com","phoneNo":"1235854433","firstName":"amber","lastName":"lei","stlogreet":"7148 Pacific Blvd, Huntington Park, CA","postalCode":"90225","city":"Huntington Park","state":"CA","country":"MX","street":"street"}}' \
--data-urlencode 'redirectUrl=http://192.168.1.56:8003/redirectV2u0' \
--data-urlencode 'sign=505f3091cb56e5569b9c74e2767000cc' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'terminalType=WEB' \
--data-urlencode 'transactionExpirationTime=120' \
--data-urlencode 'transactionId=202305260151415' \
--data-urlencode 'transactionType=pay' \
--data-urlencode 'userInfo={"ip":"127.0.0.1","email":"amber.lei@useepay.com"}' \
--data-urlencode 'version=1.0'

返回响应

🟢200成功

application/json

Body

amount

string

必需

redirectUrl

string

必需

resultCode

string

必需

sign

string

必需

errorCode

string

必需

transactionId

string

必需

errorMsg

string

必需

token

string

必需

transactionType

string

必需

reference

string

必需

redirectMethod

string

必需

echoParam

string

必需

redirectParam

string

必需

reserved

string

必需

signType

string

必需

currency

string

必需

merchantNo

string

必需

示例

成功示例异常示例

{
  "amount": "100",
  "redirectUrl": "https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx1514445828520542a65b21d0b036180000&package=1318043888",
  "resultCode": "redirect",
  "sign": "93c742fcb66056d777d5ef3b482ba247",
  "errorCode": "3200",
  "transactionId": "202401150244474",
  "errorMsg": "Payment in progress",
  "token": "mop:mapi:redis:99172010-b371-11ee-b189-a02412526ed9",
  "transactionType": "pay",
  "reference": "1012401151444017307",
  "redirectMethod": "GET",
  "echoParam": "echoParam",
  "redirectParam": "{\"package\":\"1318043888\",\"prepay_id\":\"wx1514445828520542a65b21d0b036180000\"}",
  "reserved": "",
  "signType": "MD5",
  "currency": "HKD",
  "merchantNo": "500000000007264"
}

🟢200失败

Jsapi支付下单接口

GoogePay Test card