快捷下单
支持在微信、支付宝、手机浏览器等环境下打开银行或三方机构的快捷支付站点,输入银行卡、身份证、账户名、手机号,验证后银行卡扣款支付。
请求接口
openapi/v2/pay/trans/quickpay
公共参数
[接口协议 - 公共参数](/docs/openapi/v2/dev/rule/params.md
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
| amount | 是 | int | 支付金额,单位分 |
| out_trade_no | 是 | String(32) | 业务订单号,业务方保证唯一 |
| subject | 是 | String(127) | 商品名或订单简要描述 |
| client_ip | 是 | String(32) | 客户端IP |
| time_start | 否 | String(20) | 订单生成时间,格式为:yyyy-MM-dd HH:mm:ss,不传默认为当前时间 |
| time_expire | 否 | String(20) | 订单失效时间,格式为:yyyy-MM-dd HH:mm:ss,建议:最短失效时间间隔大于1分钟 |
| currency | 否 | String(16) | 货币类型,默认人民币:CNY |
| limit_credit | 否 | int | 是否限制使用信用卡,1为限制,0或不传为不限制,默认为0 |
| attach | 否 | String(127) | 附加信息,会跟订单信息一起原样返回 |
| goods_tag | 否 | String(32) | 商品标记,优惠券或单品营销使用 |
| goods_details | 否 | Json | 商品详情,Json结构,做单品优惠时传入。goods_details结构 |
| notify_url | 否 | String(256) | 支付回调地址URL,不带参数 |
| return_url | 否 | String(256) | 前端返回URL,若不为空则支付完成或取消支付后,页面跳转至此URL |
| out_user_id | 否 | String(64) | 业务系统用户id,业务方保证唯一。当传入后,下次支付会根据此user_id获取已成功绑定的银行卡、身份证等信息,用户可不需输入 |
| acct_name | 否 | String(32) | 账户名,用于快捷支付时显示已录入信息,传入后不可修改 |
| card_no | 否 | String(32) | 银行卡号,用于快捷支付时显示已录入信息,传入后不可修改 |
| id_card_No | 否 | String(32) | 身份证号,用于快捷支付时显示已录入信息,传入后不可修改 |
| phone | 否 | String(32) | 银行卡绑定手机号,用于快捷支付时显示已录入信息,传入后不可修改 |
content请求示例
{
"amount": 2000,
"out_trade_no": "20241212180000001",
"subject": "云商品",
"client_ip": "61.144.11.222",
"notify_url": "http://p.abc.com/callback/20241212180000001/",
"goods_tag": "item_water12",
"return_url": "https://www.yoursite.com/home/index.html",
"user_id": "A1234567890001"
}
响应参数
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| pay_no | 是 | String | 聚合支付订单号,'600'开头 |
| out_trade_no | 是 | String | 业务订单号 |
| amount | 是 | int | 交易金额,单位:分 |
| url | 是 | String | 快捷支付跳转链接 |
result返回值示例
{
"pay_no": "60086150032145781",
"out_trade_no": "20241212180000001",
"amount": 2000,
"url": "https://cash.xxxdomain.com/cashier/uc?token=b7ecf68e-9bd6-4524-8c48-96734e3e2366"
}