跳到主要内容

快捷下单

支持在微信、支付宝、手机浏览器等环境下打开银行或三方机构的快捷支付站点,输入银行卡、身份证、账户名、手机号,验证后银行卡扣款支付。

请求接口

openapi/v2/pay/trans/quickpay

公共参数

[接口协议 - 公共参数](/docs/openapi/v2/dev/rule/params.md

请求参数

参数必填类型说明
amountint支付金额,单位分
out_trade_noString(32)业务订单号,业务方保证唯一
subjectString(127)商品名或订单简要描述
client_ipString(32)客户端IP
time_startString(20)订单生成时间,格式为:yyyy-MM-dd HH:mm:ss,不传默认为当前时间
time_expireString(20)订单失效时间,格式为:yyyy-MM-dd HH:mm:ss,建议:最短失效时间间隔大于1分钟
currencyString(16)货币类型,默认人民币:CNY
limit_creditint是否限制使用信用卡,1为限制,0或不传为不限制,默认为0
attachString(127)附加信息,会跟订单信息一起原样返回
goods_tagString(32)商品标记,优惠券或单品营销使用
goods_detailsJson商品详情,Json结构,做单品优惠时传入。goods_details结构
notify_urlString(256)支付回调地址URL,不带参数
return_urlString(256)前端返回URL,若不为空则支付完成或取消支付后,页面跳转至此URL
out_user_idString(64)业务系统用户id,业务方保证唯一。当传入后,下次支付会根据此user_id获取已成功绑定的银行卡、身份证等信息,用户可不需输入
acct_nameString(32)账户名,用于快捷支付时显示已录入信息,传入后不可修改
card_noString(32)银行卡号,用于快捷支付时显示已录入信息,传入后不可修改
id_card_NoString(32)身份证号,用于快捷支付时显示已录入信息,传入后不可修改
phoneString(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_noString聚合支付订单号,'600'开头
out_trade_noString业务订单号
amountint交易金额,单位:分
urlString快捷支付跳转链接

result返回值示例

{
"pay_no": "60086150032145781",
"out_trade_no": "20241212180000001",
"amount": 2000,
"url": "https://cash.xxxdomain.com/cashier/uc?token=b7ecf68e-9bd6-4524-8c48-96734e3e2366"
}