Jsapi支付下单接口
POST/apiRequest 参数详细描述
PayerInfo 付款人信息
| 参数 | 必选 | 类型 | 说明 |
|---|---|---|---|
| paymentMethod | Y | String | 目前固定为 wechat_jsapi |
| sub_appid | Y | String | 公众号id |
| sub_openid | Y | String | 消费者的openid |
orderInfo 订单信息
| Text | 必选 | 类型 | 说明 |
|---|---|---|---|
| subject | Y | 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 大写字母货币代码(货币单位) | Y |
| amount | 订单金额 | Y |
| redirectParam | 微信公众号支付需要的参数Json String | N |
| signType | 签名类型 | Y |
{
"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": "1663122586556",
"package": "prepay_id=wx1410294747107604126381be3c62a80000",
"paySign": "qnYD6nuEZc3odQmXeGNvzD6ls65juKBuym6/rH7KClgbOuK9NXCyjC8B300eUEGRNMPlZCuAkiDDSeKj79yn2Vs/QXMwwJKlxuybrRHUw0vEb4oYkt2t0p9ugIQUYkbTzznfCcUKFhPS+lkYZXczBRLjGe+644zWRqnuUTy91h3GD250tbfwlybK+7y1hF6yp/JN9e8WsjXmbXu7Ah9NknMQ3aJtDk8GXD0MWPeylLlFfGo5J7DAIVcXmYrlMf6PKr+7vnwyrLZux24jscWayK6kHepfDQgh+PkZpCEp/hW4x8fltvfgecN3Yq22bsNmlweZWACnzleB8Gl/y6fr8A==",
"appId": "wxbd881f2b1b6c426d",
"signType": "RSA",
"nonceStr": "1663122586556"
}
请求参数
Header 参数
Content-Type
string
必需
示例值:
application/x-www-form-urlencoded
Body 参数application/x-www-form-urlencoded
transactionType
string
必需
交易类型 : pay
示例值:
pay
version
string
必需
目前固定为 1.0 (5)
示例值:
1.0
signType
string
必需
商户生成签名字符串所使用的签名算法类型，目前支持：RSA/MD5
示例值:
MD5
merchantNo
string
商户号(16)
示例值:
500000000007362
transactionId
string
商户订单号(64)
示例值:
202212070142347
transactionExpirationTime
string
可选
可选 范围1-120
示例值:
120
appId
string
网站域名(128)
示例值:
www.pay.com
amount
string
必需
支付金额，单位为对应币种的最小货币单位(详见 ISO 4217)(12)
示例值:
123
currency
string
必需
3 位 ISO 大写字母货币代码(详见 ISO 4217) 目前仅支持EUR(3)
示例值:
USD
notifyUrl
string
异步通知(512)
示例值:
https://gatewaytest.useepay.com/gateway-test/notifyV2u0
echoParam
string
可选
回声参数，响应报文会原样返回(256)
示例值:
echoParam
payerInfo
string
必需
Json格式的String 付款方信息, 请下方
示例值:
{ "paymentMethod": "wechat_jsapi", "sub_appid": "公众号id" , "sub_openid": "消费者的openid"}
orderInfo
string
可选
json string, 订单信息, 请参考下方
示例值:
{ "subject": "订单标题"}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
amount
string
可选
max=12 交易金额 ISO 4217
redirectUrl
string
可选
maxlength=512重定向请求的跳转地址
resultCode
enum<string>
必需
max=32 业务结果（详见 业务结果码）
枚举值:
pendingsucceedfailed
sign
string
必需
签名值，签名方法请参加《签名指导》章节
errorCode
string
可选
max=4 错误码（详见 错误码 errorCode）
transactionId
string
必需
商户订单号 (max 64)
errorMsg
string
必需
max=256 错误码消息描述
transactionType
string
必需
reference
string
必需
redirectMethod
string
可选
echoParam
string
可选
maxlength:256 回声参数，Response 中将会原样返回
redirectParam
string
可选
resultCode=pending 时返回，微信公众号支付需要的参数Json String
signType
string
签名类型
maxlength:4 签名类型(MD5/RSA)
currency
string
币种
merchantNo
string
商户号
max=16 商户编号，由USEEPAY 分配
示例
成功示例
{
"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"
}最后修改时间： 1 年前