Jsapi支付下单接口

Pay接口

jsapi支付下单接口

POST USEEPAY_PATH/api

Headers

Name	Type	Description
content-type*	String	application/x-www-form-urlencoded

Name

Type

Description

content-type*

String

application/x-www-form-urlencoded

Request Body

Name	Type	Description
transactionType*	String	交易类型 : pay
version*	String(5)	目前固定为 1.0 (5)
signType*	String	商户生成签名字符串所使用的签名算法类型，目前支持：RSA/MD5
merchantNo*	String(16)	商户号
transactionId*	String(64)	商户订单号
transactionExpirationTime	String(6)	可选，默认为20分钟 .范围1-20
appId*	String (128)	网站域名
amount*	String(12)	支付金额，单位为对应币种的最小货币单位(详见 ISO 4217)
currency*	String(3)	3 位 ISO 大写字母货币代码(详见 ISO 4217) 目前仅支持HKD
notifyUrl*	String(512)	异步通知
echoParam	String(256)	回声参数，响应报文会原样返回
payerInfo*	String	Json格式的String 付款方信息, 请下方
orderInfo	String	json string, 订单信息, 请参考下方

Name

Type

Description

transactionType*

String

交易类型 : pay

version*

String(5)

目前固定为 1.0 (5)

signType*

String

商户生成签名字符串所使用的签名算法类型，目前支持：RSA/MD5

merchantNo*

String(16)

商户号

transactionId*

String(64)

商户订单号

transactionExpirationTime

String(6)

可选，默认为20分钟 .范围1-20

appId*

String (128)

网站域名

amount*

String(12)

支付金额，单位为对应币种的最小货币单位(详见 ISO 4217)

currency*

String(3)

3 位 ISO 大写字母货币代码(详见 ISO 4217) 目前仅支持HKD

notifyUrl*

String(512)

异步通知

echoParam

String(256)

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

payerInfo*

String

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

orderInfo

String

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

{
    "amount": "100",
    "redirectUrl": "",
    "resultCode": "pending",
    "sign": "aPkk1Y735aop9iND6byVEACwrhmWHNIRP9Hd/a36wE9g9iYMB2jXklU8QzOrOI3fJefeDl3+JcAE\nUcJXDKI8fjYUGtlA/8VhJuOmyN1xoOWSwgDr1YAGK2B+beOeFTPuWXtSsqnCoO6ebhk1soBVeT3x\nJHmPS4wSoccGXrn/VAQ=\n",
    "errorCode": "3200",
    "transactionId": "1663122582326",
    "errorMsg": "Transaction is pending",
    "transactionType": "pay",
    "reference": "1012209141029011519",
    "redirectMethod": "",
    "echoParam": "echoParam",
    "redirectParam": "{\"timeStamp\":\"1663122586556\",\"package\":\"prepay_id=wx1410294747107604126381be3c62a80000\",\"paySign\":\"qnYD6nuEZc3odQmXeGNvzD6ls65juKBuym6/rH7KClgbOuK9NXCyjC8B300eUEGRNMPlZCuAkiDDSeKj79yn2Vs/QXMwwJKlxuybrRHUw0vEb4oYkt2t0p9ugIQUYkbTzznfCcUKFhPS+lkYZXczBRLjGe+644zWRqnuUTy91h3GD250tbfwlybK+7y1hF6yp/JN9e8WsjXmbXu7Ah9NknMQ3aJtDk8GXD0MWPeylLlFfGo5J7DAIVcXmYrlMf6PKr+7vnwyrLZux24jscWayK6kHepfDQgh+PkZpCEp/hW4x8fltvfgecN3Yq22bsNmlweZWACnzleB8Gl/y6fr8A==\",\"appId\":\"wxbd881f2b1b6c426d\",\"signType\":\"RSA\",\"nonceStr\":\"1663122586556\"}",
    "signType": "RSA",
    "currency": "CNY",
    "merchantNo": "500000000007264"
}

amount=100&appId=www.pay.com&currency=HKD&echoParam=echoParam&merchantNo=500000000007381&notifyUrl=https://gatewaytest.useepay.com/notifyV2u0&orderInfo={"subject":"description"}&payerInfo={"paymentMethod":"wechat_jsapi","sub_appid":"wxbd881f2b1b6c426d","sub_openid":"oOW1us-s_y3xkl3x_VS6fxpBqHp4"}&redirectUrl=https://gatewaytest.useepay.com/gateway-test/redirectV2u0&sign=b9295adac577bae00b337a1c389a68bd&signType=MD5&transactionExpirationTime=2&transactionId=1663212415666&transactionType=pay&version=1.0

{
    "amount": "100",
    "redirectUrl": "",
    "resultCode": "pending",
    "sign": "762ee08739e984247c3af43bc5ac3f13",
    "errorCode": "3200",
    "transactionId": "1663212415666",
    "errorMsg": "Transaction is pending",
    "transactionType": "pay",
    "reference": "1012209151126671861",
    "redirectMethod": "",
    "echoParam": "echoParam",
    "redirectParam": "{\"timeStamp\":\"1663212418085\",\"package\":\"prepay_id=wx151126578017180326e42cc8c99e120000\",\"paySign\":\"CwYJyb/loSraqm048bdY13cV3rDYzIGd6ZH87SPWwEoLcijz5nP8aCMpiq1DJLJiGDib+XJsUyUd4DE2iyaDrcQMHj4XJQSz18nWpHq/sMz1ra01C4Uyd3y+wf8BFCiQMD/5V+0ma/ltpC7M8ZewKMinNCXvg0oXiDIgaFufoGEiTDzDzr/t7hoIl3YYiv1Rs7Bz5MZ9oASRiUUzZwqTU1aa42Hx54Ggt+gYaY3/hA7vzeFZBV17dmEEquEwEDsHAGn4Wkbl878OEjYwxBnuKwlrtmFs6R+uNaGA1rmMpZ2htz7D1fSjMpmKM2WofRDgSJ0cAVPSLmqLH7kDWSLYCA==\",\"appId\":\"wxbd881f2b1b6c426d\",\"signType\":\"RSA\",\"nonceStr\":\"1663212418085\"}",
    "signType": "MD5",
    "currency": "HKD",
    "merchantNo": "500000000007381"
}

Request 参数详细描述

PayerInfo 付款人信息

参数	必选	类型	说明
paymentMethod	Y	String	目前固定为 wechat_jsapi
sub_appid	Y	String	公众号id
sub_openid	Y	String	消费者的openid

参数

必选

类型

说明

paymentMethod

String

目前固定为 wechat_jsapi

sub_appid

String

公众号id

sub_openid

String

消费者的openid

orderInfo 订单信息

	必选	类型	说明
subject	Y	String	商品标题

必选

类型

说明

subject

String

商品标题

Response

字段描述是否必须

字段	描述	是否必须
resultCode	业务结果（详见业务结果码）判断交易是否成功的依据当前交易涉及的有: succeed,pending,failed, closed	Y
reference	USEEPAY 订单号	N
transactionType	支付类型 pay	Y
transactionId	商户订单号	Y
sign	签名	Y
echoParam	回声参数，响应报文会原样返回	N
errorMsg	错误码消息描述	Y
errorCode	错误码（详见错误码 errorCode）	Y
currency	3 位 ISO 大写字母货币代码(详见 ISO 4217)	Y
amount	订单金额	Y
`redirectParam`	微信公众号支付需要的参数Json String	N
`signType`	签名类型	Y

resultCode

业务结果（详见业务结果码）判断交易是否成功的依据 当前交易涉及的有: succeed,pending,failed, closed

reference

USEEPAY 订单号

transactionType

支付类型 pay

transactionId

商户订单号

sign

签名

echoParam

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

errorMsg

错误码消息描述

errorCode

错误码（详见错误码 errorCode）

currency

3 位 ISO 大写字母货币代码(详见 ISO 4217)

amount

订单金额

redirectParam

微信公众号支付需要的参数Json String

signType

签名类型

{
    "amount": "100",
    "redirectUrl": "",
    "resultCode": "pending",
    "sign": "aPkk1Y735aop9iND6byVEACwrhmWHNIRP9Hd/a36wE9g9iYMB2jXklU8QzOrOI3fJefeDl3+JcAE\nUcJXDKI8fjYUGtlA/8VhJuOmyN1xoOWSwgDr1YAGK2B+beOeFTPuWXtSsqnCoO6ebhk1soBVeT3x\nJHmPS4wSoccGXrn/VAQ=\n",
    "errorCode": "3200",
    "transactionId": "1663122582326",
    "errorMsg": "Transaction is pending",
    "transactionType": "pay",
    "reference": "1012209141029011519",
    "redirectMethod": "",
    "echoParam": "echoParam",
    "redirectParam": "{\"timeStamp\":\"1663122586556\",\"package\":\"prepay_id=wx1410294747107604126381be3c62a80000\",\"paySign\":\"qnYD6nuEZc3odQmXeGNvzD6ls65juKBuym6/rH7KClgbOuK9NXCyjC8B300eUEGRNMPlZCuAkiDDSeKj79yn2Vs/QXMwwJKlxuybrRHUw0vEb4oYkt2t0p9ugIQUYkbTzznfCcUKFhPS+lkYZXczBRLjGe+644zWRqnuUTy91h3GD250tbfwlybK+7y1hF6yp/JN9e8WsjXmbXu7Ah9NknMQ3aJtDk8GXD0MWPeylLlFfGo5J7DAIVcXmYrlMf6PKr+7vnwyrLZux24jscWayK6kHepfDQgh+PkZpCEp/hW4x8fltvfgecN3Yq22bsNmlweZWACnzleB8Gl/y6fr8A==\",\"appId\":\"wxbd881f2b1b6c426d\",\"signType\":\"RSA\",\"nonceStr\":\"1663122586556\"}",
    "signType": "RSA",
    "currency": "CNY",
    "merchantNo": "500000000007264"
}

redirectParam

字段	描述	是否必须
timeStamp	时间戳	Y
package	统一下单接口返回的prepay_id参数值，提交格式如：prepay_id=***	Y
paySign	微信签名	Y
appId	公众号名称，由商户传入	Y
signType	微信签名方式固定诶RSA	Y
noceStr	随机串	Y

字段

描述

是否必须

timeStamp

时间戳

package

统一下单接口返回的prepay_id参数值，提交格式如：prepay_id=***

paySign

微信签名

appId

公众号名称，由商户传入

signType

微信签名方式固定诶RSA

noceStr

随机串

{
    "timeStamp": "1663122586556",
    "package": "prepay_id=wx1410294747107604126381be3c62a80000",
    "paySign": "qnYD6nuEZc3odQmXeGNvzD6ls65juKBuym6/rH7KClgbOuK9NXCyjC8B300eUEGRNMPlZCuAkiDDSeKj79yn2Vs/QXMwwJKlxuybrRHUw0vEb4oYkt2t0p9ugIQUYkbTzznfCcUKFhPS+lkYZXczBRLjGe+644zWRqnuUTy91h3GD250tbfwlybK+7y1hF6yp/JN9e8WsjXmbXu7Ah9NknMQ3aJtDk8GXD0MWPeylLlFfGo5J7DAIVcXmYrlMf6PKr+7vnwyrLZux24jscWayK6kHepfDQgh+PkZpCEp/hW4x8fltvfgecN3Yq22bsNmlweZWACnzleB8Gl/y6fr8A==",
    "appId": "wxbd881f2b1b6c426d",
    "signType": "RSA",
    "nonceStr": "1663122586556"
}

PreviousWechat-HK Next小程序支付

Last updated 1 year ago