支付宝小程序收银台可支持“小程序跳小程序/APP 跳小程序”的场景使用,支付完成后可跳转回原小程序/APP。主要用于解决:
1)商户小程序快速接入支付;
2)APP 支付:提供小程序收银台用于 APP 支付需求的商户调用,间接实现 APP 支付的能力。
使用场景:用户在自己订单系统下单,获取了订单信息后,将相关参数传入收银台小程序,收银台小程序负责渠道下单支付,并返回结果。
支付宝小程序收银台开发指引见附录5.9
请求参数:
参数 | 参数名称 | 取值 | 可空 | 备注 |
---|---|---|---|---|
cusid | 商户号 | 平台分配的商户号 | 否 | |
orgid | 机构号 | 平台分配的机构号 | 是 | |
appid | 应用ID | 平台分配的APPID | 否 | |
version | 版本号 | 默认为12 | 否 | |
trxamt | 付款金额 | 单位为分 | 否 | |
reqsn | 商户订单号 |
订单号码 支持数字、英文字母、_、-、*、+、# 其他字符不建议使用 |
是 | |
unireqsn | 商户唯一订单号 |
unireqsn与原订单号reqsn二选一 当2个订单号并存时 优先取原reqsn的订单号原有逻辑 reqsn订单号原有逻辑 同一订单号在微信/支付宝/云闪付等渠道 可以同时存在下单 unireqsn订单号新逻辑 同一订单号在微信/支付宝/云闪付渠道下单时 系统会寻找当前商户其他相同unireqsn订单号 未支付的订单进行关单处理。 |
是 | |
expiretime | 绝对时间 | yyyyMMddHHmmss | 是 | 截止支付时间 |
notify_url | 服务器异步通知页面路径 |
交易完成后 平台会将交易结果以后台通知的方式发送到该地址 商户需要以此通知判断用户订单交易是否成功 |
否 | |
body | 订单标题 | 订单描述信息,展示在收银台 | 否 | |
remark | 订单备注信息 | 通知会原样带上 | 是 | |
validtime | 有效时间 | 订单有效时间,以分为单位,默认为5 | 是 | 超时后,该订单不允许再进行支付 |
paytype | 支付方式 | A02 | 否 | |
limit_pay | 支付限制 | no_credit--指定不能使用信用卡支付 | 是 | 32 |
asinfo | 分账信息 |
格式: cusid:type:amount;cusid:type:amount… 其中 cusid:接收分账的通联商户号 type分账类型(01:按金额 02:按比率) 如果分账类型为02 则分账比率为0.5表示50% 如果分账类型为01 则分账金额以元为单位表示 |
是 | 开通此业务需开通分账配置 |
randomstr | 随机字符串 | 商户自行生成的随机字符串 | 否 | |
subbranch | 门店号 | 是 | 通联系统门店号 | |
signtype | 签名类型 |
RSA RSA2 SM2 |
||
isdirectpay | 是否直接支付 | 1直接支付 0或空时不变 | 是 | |
ishideshare | 是否禁止分享 | 1禁止分享 0或空时支持分享 | 是 | |
idno | 证件号 | 实名交易必填.填了此字段就会验证证件号和姓名 | 是 | |
truename | 付款人真实姓名 | 实名交易必填.填了此字段就会验证证件号和姓名 | 是 | |
fqnum | 支付宝分期 |
3 花呗分期3期 6 花呗分期6期 12 花呗分期12期 24 花呗分期24期 3-cc 支付宝信用卡分期3期 6-cc 支付宝信用卡分期6期 12-cc 支付宝信用卡分期12期 24-cc 支付宝信用卡分期24期 3,1 花呗分期3期(商户贴息) 6,1 花呗分期6期(商户贴息) 12,1 花呗分期12期(商户贴息) 24,1 花呗分期24期(商户贴息) 3-cc,1 支付宝信用卡分期3期(商户贴息) 6-cc,1 支付宝信用卡分期6期(商户贴息) 12-cc,1 支付宝信用卡分期12期(商户贴息) 24-cc,1 支付宝信用卡分期24期(商户贴息) |
是 | |
extendparams | 拓展参数 |
json字符串,注意是String 一般用于渠道的活动参数填写 |
是 | 参考拓展参数附录说明 |
sign | 签名 | 详见安全规范 | 否 |
响应参数:
字段ID | 字段名称 | 取值 | 可空 | 备注 |
---|---|---|---|---|
code | 响应码 |
success:支付成功 cancel:取消支付 fail:支付失败 |
否 | |
errmsg | 响应内容 | 是 | 当code为cancel、fail有值 |