4.4支付宝小程序收银台


支付宝小程序收银台可支持“小程序跳小程序/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或空时支持分享  
isdirectback 支付完成是否直接返回

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有值

yinjr 2025年5月28日 17:16 收藏文档