支付宝小程序收银台

一、支付产品介绍

1.1 产品概述

通联支付宝小程序收银台是通联面向支付宝小程序生态推出的一站式聚合收银产品，商户无需自研支付界面，仅需接入通联标准接口，即可在小程序内一键唤起标准化收银台，支持支付宝支付、多渠道支付方式扩展，实现下单 —— 支付 —— 回调 —— 对账全链路闭环，大幅降低商户开发与接入成本，优化用户支付体验，提升支付转化率。

1.2 适用场景

支付宝小程序收银台仅适用于支付宝小程序内跳转通联收银台完成的线上交易场景，依托已认证的支付宝小程序与通联收银台小程序实现，是无开发能力、轻量交易、多渠道收款类小程序商户的便捷支付方式，适配快速接入、极简收款、聚合支付、临时收费等轻量化交易需求。

业务场景	场景特点	典型案例
电商零售	商品下单、购物城结算一键支付	美妆、服饰、生鲜同城配送小程序
本地生活	预约到店核销、外卖点餐	餐饮、洗车、美甲、家政服务小程序
文旅出行	门票、行程预约	景区、场馆、网约车小程序
虚拟服务	会员充值、课程缴费	教育知识付费、影院会员小程序

1.3 商户入网

商户需联系通联支付分公司人员签署合作协议，提交上述入网材料，经通联支付审核通过后，完成支付宝商户号与通联收银宝商户号的绑定，方可正式开通支付宝小程序收银台产品。

二、技术开发准备（仅针对需对接API商户）

第一步：密钥获取（云梯）

设置商户公私钥、加密key

第二步：公共参数获取（云梯）

下载通联公钥

第三步：对接规范

调用通联接口，统一使用POST形式提交，数据格式统一为JOSN，相关SDK及签名方法如下：SDK示例：https://prodoc.allinpay.com/doc/1360/

三、开发指引

3.1 核心开发内容

开发模块	核心功能	关联接口
订单生成	生成小程序预支付订单，传入 user_id、订单金额等核心参数（特别说明：将云商通返回的 “appletPayParams - 收银宝小程序收银台支付参数” 中的字段名及字段值全部原样作为入参放进 my.navigateToMiniProgram 的 extraData，否则调用小程序会失败）	【2085-消费申请】
支付调起	将预支付参数透传至通联收银台小程序，跳转appid固定为2021001104615521 微信小程序收银台支付调起说明详见：https://prodoc.allinpay.com/doc/1056/	商户小程序跳转收银台
支付结果回调处理	验证通联及支付宝双重签名，更新商户系统订单状态，回复「success」防止重复回调	【订单结果通知】
订单查询	未收到支付回调时，主动查询订单实时状态；支持按商户订单号 / 通联订单号查询	【3001-订单状态查询】、【3002-订单结果查询】
退款（可选）	处理用户退款请求，支持全额 / 部分退款，资金原路退回用户微信支付账户	【2294-退款申请】
订单对账	下载交易、退款、手续费明细对账文件，完成财务资金核对	【4002-对账单文件下载】

3.2 对接规范

测试地址：https://ibstest.allinpay.com/yst/yst-service-api/tx/handle

生产地址：https://ibsapi.allinpay.com/yst-service-api/tx/handle

核心扣款接口：【2085 - 消费申请】、【2089 - 担保消费申请】，支付模式固定上送 “ALIPAY_MINIPROGRAM_CASHIER_VSP - 支付宝小程序收银台”，不可修改。

调用规则：所有通联支付宝小程序支付相关接口，统一使用 POST 方式提交，请求数据格式为 JSON，接口编码为 UTF-8。

开发参考：通联官方 SDK 示例、签名方法、接口详情可参考通联支付开发者文档：https://prodoc.allinpay.com/doc/1360/

3.3 消费流程

1.用户在支付宝内打开商户小程序，浏览商品/服务后提交订单，确认订单金额、收货/核销信息。

2.商户小程序后端将商户订单号、订单金额等参数传入通联【2085 - 消费申请】接口（支付模式指定为 ALIPAY_MINIPROGRAM_CASHIER_VSP）。

3.通联支付系统接收请求后，请求支付宝服务器发起交易。通联系统在得到预支付标识后，将验签后的参数appletPayParams 传递给商户系统。

4.商户系统将拿到的appletPayParams 原封不动塞进 navigateToMiniProgram 的 extraData，同时跳转通联支付宝收银台固定小程序 appId：2021001104615521。

5.用户在收银台内确认支付，完成密码/指纹/面容验证，支付宝支付完成实时扣款。

6.支付宝支付将支付结果同步至通联支付系统，通联系统通过【订单结果通知】接口异步推送支付结果至商户小程序后端；若商户未收到回调，可主动调用订单查询接口获取订单终态。

支付宝小程序收银台必填字段

字段	字段类型	是否必填	字段说明
payMode	JSONObject	是	支付模式固定传值： ALIPAY_MINIPROGRAM_CASHIER_VSP
payAmount	Long	是	实际支付金额（单位：分），与用户实际扣款金额一致
orderAmount	Long	是	订单总金额（单位：分），无优惠时需与 payAmount 完全一致
reqTraceNum	String	是	商户订单号，全局唯一，不可重复

支付宝小程序收银台核心返回参数

字段	字段类型	是否必填	字段说明
respTraceNum	String	是	通联订单号，用于后续订单查询、退款、对账等操作
appletPayParams	String	是	收银宝小程序收银台支付参数，跳转通联收银台时将参数字段全部透传
respCode	String	是	业务返回码：00000 = 请求成功；66666/66667 = 处理中（需等待回调/主动查询）；其他编码 = 请求失败
respMsg	String	是	业务返回说明，失败时返回具体原因（域名配置错误、金额异常等）
result	String	否	订单实时状态，如交易成功、交易失败

可选扩展字段

字段	字段类型	是否必填	字段说明
orderValidTime	String	否	订单有效期，格式：yyyy-MM-dd HH:mm:ss，默认 1 小时，最长支持 2 小时
extendParams	String	否	渠道拓展参数，最长 1000 字符，可传入小程序页面路径、商品类型等自定义信息

3.4 退款流程

支付宝小程序收银台的退款流程与支付宝支付原生规则一致，支持全额退款、部分退款及多次退款，累计退款金额不得超过原订单实际支付金额，退款资金将原路退回用户支付宝支付绑定的银行卡/余额/余额宝，退款时效由支付宝支付及银行处理规则决定。

退款申请接口必填参数

字段	字段类型	是否必填	字段说明
orderAmount	Long	是	本次退款金额（单位：分），单次退款金额需大于 0
reqTraceNum	String	是	商户退款单号，全局唯一，不可重复
orgRespTraceNum	String	否	原通联订单号（与原商户订单号二选一）
orgReqTraceNum	String	否	原商户订单号（与原通联订单号二选一）
orgTransDate	String	否	原订单交易日期，格式：yyyy-MM-dd（传原商户订单号时必填）
respUrl	String	否	退款结果异步通知地址，需为 HTTPS 域名，用于接收退款成功 / 失败通知

退款操作规则

1.调用退款接口时，orgRespTraceNum（原通联订单号）或 orgReqTraceNum+orgTransDate（原商户订单号 + 原交易日期）两组参数二选一即可，无需重复传入。

2.多次退款时，每次退款需生成唯一的商户退款单号，避免重复退款；累计退款金额不得超过原订单实际支付金额，超出将被系统直接拒绝。

3.退款申请提交后，通联支付系统实时受理，支付宝/银行处理时效为 1-3 个工作日，退款结果将通过 respUrl 异步推送至商户系统；商户也可调用订单查询接口查询退款状态。

4.订单已完成资金结算、超过支付宝支付退款有效期的，将无法通过接口发起退款，需通过线下人工方式处理。

3.5 订单管理

支付宝收银台支付订单在商户系统内需遵循统一状态流转规则，禁止自定义订单状态，确保交易全链路可追溯、可对账、可排查，状态定义与微信支付原生规则一致：

订单类型	订单状态	场景
消费	0：进行中	待支付：商户成功调用通联消费申请接口，成功调起通联收银台，等待用户确认支付。支付中：用户已打开支付收银台，输入密码/验证身份，微信支付通道处于交易处理中。
	1：交易成功	支付成功：支付宝完成扣款，通联支付推送成功回调，订单资金将按结算规则划转至商户账户。
	2：交易失败	支付失败：用户主动取消支付、密码错误、余额不足、银行卡异常、风控拦截、域名配置错误等，支付流程终止。已关闭：订单超过orderValidTime 未支付，系统自动关闭；或商户主动关闭未支付订单。
退款	0：进行中	退款中：商户已调用退款接口，通联支付受理请求支付宝/银行正在处理退款。
	1：交易成功	退款成功：资金已原路退回用户支付宝账户，退款流程完结。
	2：交易失败	退款失败：订单已结算、超过退款有效期、支付通道拒绝、商户账户余额不足等，退款无法完成，通联支付返回具体失败原因。

3.6 订单对账

为满足商户财务对账、资金核对、税务申报等需求，通联支付为微信小程序收银台提供多渠道、自动化的对账文件下载服务，对账文件包含所有的交易、退款、手续费、结算等明细，可与商户其他支付方式的对账文件合并展示，支持按日/按月查询与下载。

门户下载对账文件:门户下载对账文件：可在商户门户【对账单下载】菜单下载对账文件

调用API 接口获取对账文件

商户可调用通联【4002 - 对账单文件下载】接口，自动拉取日度/月度对账文件，支持批量下载、定时拉取，适配商户财务系统自动化对账需求，接口详情参考通联官方文档：https://prodoc.allinpay.com/doc/476/。