主题
免验快捷支付
接口描述
- 免验快捷支付。
请求URL
/trade/quickPayExpress
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202415629590370906 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间,13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| merchantNo | 是 | string | 32 | 商户编号 | XS240820000054 |
| signNo | 是 | string | 64 | 快捷签约协议号 | |
| payerIp | 是 | string | 64 | 付款方ip | |
| outTradeNo | 是 | string | 32 | 接入方交易流水号 | OUT00000001 |
| tradeAmount | 是 | string | 20 | 交易金额(单位分) | 100 |
| tradeSubject | 是 | string | 255 | 交易标题 | 苹果手机 |
| subsidyAmount | 否 | string | 20 | 补贴金额(单位分) | 100 |
| tradeCategory | 否 | string | 20 | 交易类别 NORMAL:普通交易(默认值),ENSURE:担保交易 | NORMAL |
| expiryTime | 否 | string | 订单超时时间(单位分钟,不超过1440分钟);默认30分钟 | 30 | |
| notifyUrl | 否 | string | 255 | 通知回调地址 | https://aaa.bbb.com/trade/notify |
| 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 |
公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间,13位时间戳 | 1731406784607 |
响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| tradeNo | 是 | string | 32 | 支付系统交易流水号 | 1854100814175592449 |
响应示例
json
{
"code": "00000000",
"message": "成功",
"tradeNo": "1856544267009564674",
"transDate": "1731469621597",
"transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
"signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g=="
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述