USEEPAY

扫码支付收银台模式(wechat_native)

全球收单-SandBox环境

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

POST

/cashier

产品展示

时序图

请求参数对象说明

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

请求参数

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_native","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_native","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

订单金额

必需

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

redirectUrl

string

收银台地址

可选

异步通知地址 resultCode = pending 出现

resultCode

enum<string>

业务结果码

必需

参考业务结果码

枚举值:

pendingsucceedreceivedfailedcancelledclosed

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

币种

可选

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

merchantNo

string

商户号

必需

商户号(max=16)

version

string

版本

必需

版本固定1.0

示例

成功示例异常示例

{
    "amount": "100",
    "redirectUrl": "https://checkout1.dev.useepay.com/v2?accessToken=eAF1Vl9vG0UQ_y5XtU-Jc3v2nf9IVUncmIYmqYMTWlpXaL27tpfc7R67e3YuIRK89I_UqkVQhFQhVX0pElIFvICg0O-C6ro88RWYvfPFJhRLPt_OzM7Mzvx-sz5yFNNJaJzGkRNibbZxxJyGEzLuLDlccFOmuo0VjjRIj7oOkcJwkbA9FXadRtcZM37ARWNlZXwQ43Slxw_hJ1HhhVh1u4nrlilVeLQjdw4Pu86x9ambWOwknOy3cQo-hQRhPJSCbUtYIq_s1_xKpVwGcZ-rk4xw1GPKmuKUqQ3RB-Ojtxr85xREJsIoG2vrGjjAiRlKxQ-x4VJsMVhQUJHRKHceMWFOpGNGhth8JMB2xJzjJWeADRvjtCMTRWyd9jrr6-3VD09vhWLdOHIIVnQ3jVm-MvAGO065vLnkiLzkucI5BolUdH5G8KI4LG2W4_G4BAUoERlBSJIoxQSxJ9vrXATBQEqq89o4N6BZPMIDlrVp8ujW5MvPJ4__mN69Dd3pOktd55MEQy9NCgYIlrHiJDdGXqlcyUxsaov7H96fPvsh03C6IJ---Hry4OdMTqBAA6nSXcUWd05__G36-PnrJ1_8_eLeq1_uTx7em_76bHLn-1z-6veX06---_Ozbz-F7-TOrcndnzJnPUltdl0nT__1gwdvXubhizAL2txVtk_vJwuKbAUH7CksFrOGgkzv3ss2ZCU5iZOtjm8WBZ1R4s3zp5P7j14_uf3X029AFTEF2BDmStYr2xzP9cqu7wUuQnVUD8Am76PVIReAbZWo7MG777sI9AYy0qsRkA8M3EJgIQMSjcMMcizCPIR1RoASEPOdRDM2RwEOw6YUfT4oSIEpjg1wpeG4FfBJsCAsfJ-ZRIk9ZT0NjYktYwFMPcxpUsAJjjNgm_BIADZgZ1MkimEjrTNMIy5WQcSAiZQy2goHNoaVCLrLI9aUYWZ5Jgi8tVYLFIPINK0DZtUAs6CCykE9QFVUCzLtlqS8nxbaqu9Wy1VUr9U8GBRQt7prX3RnKMdNy2Iqx2KWWDjPkwkIBVUSuzBFQH2m1XLhY4U215w6UGD7gfpXM0XevYxVfq6yz6pX8RfUm3Jgh5ItmIaKDam3rIfLhmlTklovEwFLyGOIeQmHPE0E0baYK1GsYzA467XyDOCFYD0EGsPbqXAgCSEM_ACAPPhByD4q8KAVrx8QElR7Lq54uFoLPJ_6rI-Car-GvN5sD0KognwLq9LH8eDClU5nlRCm9WWWbtDzm7urG5VWumuGPqrS6_F1v0_i_cuXzq0fxByG_3kU1KDuXh155zp8ALMuUey8e03oUKxDhNW0F7jNs95abVzGsA53DrbfY-7Zsp04BQtmHBlxYsECcttXOC4U7wQ3ANk1c9Ij14UTrIGpFSfGSNHmBwzgCR2PAVBcDNoyDC00YH76IFR8hEkKQk7SHMinEawYhRMRA6gq8KsBOqtxvIbVJX-GnLmoTRZEazy05LCwsRZ2CTlcZJooHucUsITIdBLyja4CvRf2N2HaD2VIZ-O8sG3CxZJTye5sSZlTs1C_a0c2hSALRpnslJsZEovssqljGZKR1Hq-ynqam5NjG6zM2zmpU7EtDXQHZujiDWhdGxbFIdDV0sIHVNWqc9msxdtsfElqw2gbp_aubNtZMbfKG7My8jKZivSVPkwnym2oedPm0ysbgTZRmdgx6NVqWR4q3ZQEF_2Agbc1G7ed_Iyucwy3cdHvf401VPdKAOkSKvlBowb_QFYKsw-8xDovMPs_3Le39rbcTIaiOWRk32kYlTD42xDHIYMzF4lsUDh8gfHCpSV_ScM105MHpdmYtoWQ-zCjGsCKuBHhmDdsRrqBWNn3-313ud-r-csIMbpcD_p4GVdRz6tWygGMSef4H2YRR08%3D",
    "resultCode": "pending",
    "sign": "4656fc2285b5bda56d99e21f87c5cd83",
    "errorCode": "3200",
    "transactionId": "202305260119196",
    "errorMsg": "Transaction is pending",
    "transactionType": "pay",
    "reference": "1012305261321015501",
    "echoParam": "echoParam",
    "reserved": "",
    "signType": "MD5",
    "currency": "USD",
    "merchantNo": "500000000007245"
}

🟢200签名失败

扫码支付 Server To Server模式

小程序支付

扫码支付收银台模式(wechat_native)

产品展示#

时序图#

请求参数对象说明#

payerInfo#

orderInfo#

userInfo#

请求参数

示例代码

返回响应

产品展示

时序图

请求参数对象说明

payerInfo

orderInfo

userInfo