云商通收银台

一、支付产品介绍

云商通收银台是通联支付云商通2.0平台提供的聚合支付产品，支持商户通过统一的收银台页面，一站式完成微信、支付宝、银联云闪付等多渠道支付，无需对接多套支付接口即可获得完整的收银台前端能力。

业务场景	场景特点	典型应用案例
线上电商平台	平台商家在PC端网页或H5商城生成订单，用户进入云商通收银台自主选择支付方式完成支付。	电商平台、知识付费平台等，用户下单后跳转至统一收银台，支持微信、支付宝、云闪付。
担保交易场景	部分平台采用担保交易模式，用户支付资金先进入平台担保户，待用户确认收货后再结算至收款方。	二手交易平台、B2B撮合平台、社区团购平台，调用【担保消费】接口使用云商通收银台，保障买卖双方资金安全。
线上线下收银一体化	平台商户通过云商通生成的收款码牌，实现线下门店扫码收款。	连锁门店、品牌零售店，顾客线下扫码后支付，交易信息同步至云商通后台。
集中收银场景	批发市场、大型商超等场所，由平台集中收银，再通过云商通自动清分至各档口或商户，适配行业收银台的场景化模板功能。	农贸市场、美食广场、家居建材城，消费者在收银台统一付款，系统按规则分账至各个摊主或品牌方账户。

商户可联系通联分公司人员签署协议提交入网材料，审核通过入网成功后，即可进行支付产品开通。

第一步：设置商户公私钥、加密key

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

下载通联公钥

第三步：对接规范

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

功能	接口（链接）	描述
订单生成	【消费申请】	支付模式上送"CASHIER_YST-云商通收银台"，创建订单并获取收银台付款地址
支付结果回调处理	【订单结果通知】	验证回调签名、更新订单状态、回复「success」
订单查询	【订单查询】、【订单详情查询】	查询订单状态（未收到回调时使用）或获取订单详细信息
退款	【退款申请】	处理用户退款请求，支付金额原路退还
订单对账	【应用集合对账文件下载】	下载商户对账文件

送payType：创建订单后直接唤起对应的支付方式（微信/支付宝/云闪付/银行卡快捷），用户进入收银台即开始支付。

不上送payType：创建订单后返回收银台页面，用户自主选择支付方式后发起支付。

调用【行业收银台下单】接口时，支付产品为云商通收银台需特别注意的字段：

字段	字段类型	是否必填	字段名称
payMode	JSONObject	是	支付模式。支付产品为云商通收银台时，payMode=CASHIER_YST
vspCusid	String	否	收银宝子商户号。集团模式下必填，账后结算模式下需校验与收款会员的绑定关系
limitPay	String	否	限制支付方式。no_credit：限制非贷记卡；不填则表示借记卡、贷记卡均支持
payType	String	否	指定支付方式。枚举值：YHK（银行卡快捷）、WX（微信）、ZFB（支付宝）、YSF（云闪付）
benefitDetail	JSONObject	否	优惠信息，JSON字符串格式，支持微信单品优惠
goodsTag	String	否	订单支付标识，用于区分订单是否可以享受优惠
orderValidTime	String	否	订单过期时间，格式：yyyy-MM-dd HH:mm:ss，不上送默认1小时

响应参数重点关注字段：

若订单长时间未返回最终状态，可调用【订单查询】或【订单详情查询】接口获取最新订单状态。

若用户需要退款则可调用退款接口，将接口调用成功后支付金额将原路退还给客户。退款需上传参数如下：

上传参数时“orgRespTraceNum”和“orgReqTraceNum+orgTransDate”二选一即可成功调用退款接口

退款支持部分退款和全额退款，同时支持多次退款。退款金额不能大于支付金额。

云商通收银台的订单状态贯穿下单、支付、退款全流程，商户需根据实际场景正确处理各状态的业务逻辑。

云商通收银台订单状态说明：

订单类型	订单状态	场景说明
消费	0：进行中	待支付：订单创建成功，返回cashierUrl，等待用户打开收银台并完成支付
		支付中：用户已选择支付方式，正在处理支付或等待用户验证身份
	1：交易成功	支付成功：用户已完成扣款，资金已到账
	2：交易失败	支付失败：用户取消支付、余额不足、银行卡异常、风控拦截等原因
		已关闭：订单超过orderValidTime未支付，系统自动关闭
退款	0：进行中	退款已受理，渠道正在处理
	1：交易成功	退款成功：资金已原路退还用户账户
	2：交易失败	退款失败：超过退款有效期、渠道拒绝、账户异常等原因

订单状态获取方式：

异步通知：用户支付成功后通联主动推送【订单结果通知】至商户的respUrl，推荐使用。

主动查询：若长时间未收到异步通知，可调用【行业收银台订单查询】或【行业收银台订单详情查询】接口主动查询订单状态。

为满足财务对账需求，通联支持商户下载对账文件。具体方式如下：

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

调用API接口获取对账文件

2.商户可调用【下载商户对账文件】接口下载对账文件，支持日度、月度对账文件获取，文件格式支持 CSV/Excel，包含订单号、交易金额、退款金额、手续费、交易时间、支付方式等核心字段。