付款码支付

一、支付产品介绍

1.1 产品概述

付款码支付是通联面向线下实体场景推出的主流聚合支付产品，商户通过扫码枪、POS终端等条码识别设备扫描消费者手机端展示的付款码即可完成收款。产品聚合微信支付、支付宝、云闪付等主流支付渠道，支持用户出示任意渠道付款码完成支付，具备收款效率高、用户体验好、渠道覆盖广的核心特点，广泛适用于各类线下零售与服务场景。

 1.2 适用场景

该产品支持多种主流支付方式，可无缝集成于商户线下收银系统与实体门店场景，为用户提供安全、便捷、高效的一站式支付解决方案。

1.3 商户入网

1.商户主体合规合法，营业执照在有效期内，不属于通联支付禁止准入行业类目

2.完成通联收银宝商户号注册与实名认证，无不良经营记录与风控黑名单记录

3.商户经营内容与备案类目一致，不得超范围开展支付业务，不得转借支付接口与终端设备

4.配备符合银联标准的条码扫描设备或通联认证的POS终端，完成终端入库、绑定与激活，确保终端网络环境稳定

二、技术开发准备

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

点击密钥管理获取商户公钥、私钥及加密密钥。

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

点击通联公钥下载通联公钥

 第三步：对接规范

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

三、开发指引

3.1 核心开发内容

3.2对接规范

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

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

支付产品固定值：payMode=CODEPAY_VSP

请求方式：POST，数据格式 JSON，编码 UTF-8

开发文档：https://prodoc.allinpay.com/doc/1360/

3.3 消费流程

1.消费者在商户收银台出示手机付款码（微信/支付宝/云闪付等）

2.商户收银员使用扫码枪或POS终端扫描用户付款码，获取条码内容

3.商户收银系统调用通联【2085－消费申请】接口，传入订单信息与付款码内容，支付模式设为CODEPAY_VSP

4.通联系统校验订单合法性与商户权限，自动识别付款码所属渠道并转发至对应支付渠道完成扣款

5.支付渠道实时返回扣款结果，通联系统同步返回支付受理结果至商户系统

6.支付成功后，通联系统将交易终态异步推送至商户预设回调地址

7.商户系统收到通知并验签通过后，更新业务系统订单状态，完成支付流程

8.未收到异步通知时，商户可主动调用【3001－订单状态查询】接口获取订单终态

POS 支付必填字段

核心返回参数

3.4退款流程

付款码支付支持全额退款、部分退款、多次退款，累计退款金额不得超过原订单实付金额，退款资金将原路退回，退款时效取决于对应支付渠道与发卡行清算规则。

退款必填参数

退款操作规则

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

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

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

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

3.5 订单管理

收银宝 POS 支付订单需遵循统一状态流转规则，禁止自定义订单状态，确保交易全链路可追溯、可对账、可排查：

3.6订单对账

为满足商户财务对账、资金核对与多业务线管理需求，通联提供两种对账文件获取方式，对账文件包含所有付款码支付的交易、撤销、退款、手续费明细，支持按支付渠道、交易时间维度筛选：

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

2. 调用API接口获取对账文件

商户可调用接口自动下载对账文件，支持日度、月度对账文件获取，接口详情参考通联官方文档：https://prodoc.allinpay.com/doc/476/；接口调用支持批量下载、定时拉取，适配商户财务系统自动化对账需求，文件格式为CSV/Excel，包含订单号、交易金额、退款金额、手续费、交易时间、支付方式等核心字段。