主题
H5支付下单
接口描述
- 商户系统先调用该接口在甬易支付服务后台生成预支付交易单，返回正确的预支付交易会话标识后再按Native、JSAPI、App等不同场景生成交易串调起支付。
请求URL
/trade/h5Pay
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202409561403450909 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| merchantNo | 是 | string | 32 | 商户编号 | XS240820000054 |
| outTradeNo | 是 | string | 32 | 接入方交易流水号 | OUT00000001 |
| tradeAmount | 是 | string | 20 | 交易金额(单位分) | 100 |
| tradeSubject | 是 | string | 255 | 交易标题 | 苹果手机 |
| subsidyAmount | 否 | string | 20 | 补贴金额(单位分) | 100 |
| tradeCategory | 否 | string | 20 | 交易类别 NORMAL:普通交易(默认值),ENSURE:担保交易 | NORMAL |
| expiryTime | 否 | string | 订单超时时间(单位分钟，取值范围【15～1080】)；默认30分钟 | 30 | |
| notifyUrl | 否 | string | 255 | 通知回调地址 | https://aaa.bbb.com/trade/notify |
| limitPayWay | 否 | string | 限制支付方式： BANLANCE-限制余额不能交易，BANKCARD_DC-限制借记卡不能交易，BANKCARD_CC-限制贷记卡不能交易 | BANLANCE | |
| payerIp | 否 | string | 32 | 付款方ip | |
| longitude | 否 | string | 32 | 经度 | 123.12 |
| latitude | 否 | string | 32 | 维度 | 666.12 |
| psType | 否 | string | 分账类型,默认不分账：担保交易不填写分账信息 Y-分账，N-不分账； | N | |
| psDetail | 否 | string | 分账详情(json字符串) | [{"inMerchantNo":"XS240820000050","amount":50},{"inMerchantNo":"XS240820000051","amount":50}] | |
| - amount | 否 | number | 20 | 分账子订单金额(单位分)，psType为Y是必填 | 50 |
| - inMerchantNo | 否 | string | 32 | 入账商户号，psType为Y是必填 | XS240820000050 |
请求报文示例
json
{
"appId": "202415629590370906",
"merchantNo": "XS241026000093",
"outTradeNo": "18511110003547767",
"psType": "Y",
"psDetail":"[{\"inMerchantNo\":\"XS240820000050\",\"amount\":50},{\"inMerchantNo\":\"XS240820000051\",\"amount\":50}]",
"signature": "duvJ2b4V4Y+pYkwLzSvcH8VXpM2QxxeYFE9enNrSyQUTj3ckJnNy/whRV5IdPQAnfuxKyPPapmS7o0mxGRud6UUu66uKs8NsGs2qnHXEMJCFUgRVb20A42in1k5sW1jd7xCpMg49Y5w8nHnEgolopjh2WzYjLHhS5tEe1c2OH/icWwR0LD8oUyR3j6BLeY2V9Q/N/gxKN6X8/mlBDi+U/4DPiITnySKPYJRkTPqgaFTPuHXNuyaK1IaxPwHuNzCbK+lVo9Fsl7jUpm2R3CSHBevvumwzThyV4t7+CnEGdveOa+OY1A3DOckSjPwwOv1un6nmIfcluV3CtTgPya+YvA==",
"tradeAmount": "1",
"tradeSubject": "苹果手机",
"transDate": "1731469717435",
"transNonce": "66aa6aef-0eef-41b7-8f66-ed83d4e8a1a4"
}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| tradeNo | 是 | string | 32 | 支付系统交易流水号 | 1854100814175592449 |
| payUrl | 是 | string | 支付链接地址 |
响应示例
json
{
"code": "00000000",
"message": "成功",
"payUrl": "https://dev-qr.xspay.com/pay/yypayh5.html?appId=202415629590370906&transNonce=ce86b6f22571488381b87937b1e94d52&transDate=1731469714880&tradeNo=1856544661366415362&signature=O/2D3plXo1VYgdhKPdfwlQVFcU8e8fUyhup9d98FPcp3uuUyZupbsgI9tGrUjHXLTWpyZkPPqSgi6hNxteQdLGN72m25Ta3T8aCwQD8nlZoZF47eH8McI5JQ6vtTlJ6HRhne1uxGdLye5e/NP4X6vW/M2DcB4/X0LbwN22HjW4fBj2lXmEYh2N6XJxv70m9wwysanrFJfyEP+F7aDsBfy06xtmV1Y4IycM2q/3IhyQ43Rl77tyYHGO+sBTEKPz+9SpdIWSqAHKJSCS6O+v35mD2PIro/9Wf88Dg9dT3WAIOp9XlB1tdF1FJnO4zGW+WlXRbcJMcUWIi0cwVrRZqfgw==",
"tradeNo": "1856544661366415362",
"transDate": "1731469717435",
"transNonce": "66aa6aef-0eef-41b7-8f66-ed83d4e8a1a4",
"signature": "duvJ2b4V4Y+pYkwLzSvcH8VXpM2QxxeYFE9enNrSyQUTj3ckJnNy/whRV5IdPQAnfuxKyPPapmS7o0mxGRud6UUu66uKs8NsGs2qnHXEMJCFUgRVb20A42in1k5sW1jd7xCpMg49Y5w8nHnEgolopjh2WzYjLHhS5tEe1c2OH/icWwR0LD8oUyR3j6BLeY2V9Q/N/gxKN6X8/mlBDi+U/4DPiITnySKPYJRkTPqgaFTPuHXNuyaK1IaxPwHuNzCbK+lVo9Fsl7jUpm2R3CSHBevvumwzThyV4t7+CnEGdveOa+OY1A3DOckSjPwwOv1un6nmIfcluV3CtTgPya+YvA=="
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述