1、产品介绍

1.1、简介

付款码支付是用户展示（微信/支付宝/云闪付/数币等）钱包内的“刷卡条码/二维码”给商户系统扫描后直接完成支付的模式。主要应用线下面对面收银的场景。

1.2、使用步骤

1.用户登录微信、支付宝等钱包，点击首页“付款”，进入付款码界面；
2.收银员在商家收银系统操作生成订单，用户确认支付金额；
3.用户出示钱包的“付款码”，收银员用扫码设备来扫描用户手机上的条码/二维码后，商家收银系统提交支付；
4.付款成功后商家收银系统会拿到支付成功或者失败的结果。

2、接入方式

2.1、接入流程

3、开发指引

3.1、对接规范

调用星驿付接口，均采取POST形式提交，数据格式统一为JSON格式，签名方法：签名算法

3.2、支付流程

3.2.1、系统交互流程

消费者打开微信、支付宝、银联，展示付款码；

商户收银员通过扫码枪等收银工具扫码读取付款码信息；

商户业务系统调用【付款码支付】将业务订单信息、微信/支付宝/银联的付款码、设备信息传入即可；

根据返回的结果，确定支付状态，从而进行相应处理。

结果码	描述
000000	表示支付成功，可以做支付成功的后续操作
222222	支付中，等待用户付款，由于余额不足、超额、输密码等原因导致订单创建但支付未成功，等待用户付款。付款码支付由于是线下面对面支付，需尽快确认交易情况，建议通过轮询方式判断交易状态，避免单边账。
-80000	未知异常，可能由于参数错误（一般在联调阶段出现）或者系统异常或者网络超时等问题导致接口报错，建议调用查询接口确认支付结果
其它结果码	支付失败，需要重新检查参数，以及根据错误描述来确定失败原因

3.2.2、示例代码

3.3、查询交易

由于付款码支付不一定是同步返回成功的，有可能需要用户输入密码的步骤，此时返回的就是支付中，所以商家可调用订单查询接口，通过三方订单号或者星驿付订单号来查询对应订单支付情况。

3.3.1、示例代码

重要入参说明
注意： 请严格按照接口文档中的参数入参，传入非接口文档中的参数是无效的，并且可能会导致请求被拦截或其它异常。

参数名	参数说明
orderNo	支付时传入的三方订单号，与 gtOrderNo 必填一个。
gtOrderNo	支付时返回的国通平台订单号，与 orderNo 必填一个。

3.4、退款流程

由于用户或者商户的原因需要退款时，商户可以通过退款接口将支付款退还给用户，退款成功资金将原路返回。

3.4.1、退款结果

退款成功：退款是否成功可以根据同步响应的 code 和 orderStatus 参数来判断，返回值为 code=000000并且orderStatus=4或c，则表示退款成功

退款失败：根据同步响应的 code 和 orderStatus 参数来判断，code!=000000 代表退款失败，code=000000并且orderStatus=3 代表退款失败，至于是否重试，需要根据错误信息判断是否是参数有误

退款中：即code=000000并且orderStatus=5，这个状态极少情况下会出现，出现这种状态建议过5秒后调用退款查询接口查下状态，如果还是退款中状态，基本就是属于单边账了，需要对接群里咨询技术人员排查出现的原因。然后等第二天到服务商后台处理。注意：出现单边账后，即使第二天处理了，订单状态也是不会改变的，往后一直是退款中状态。

3.4.2、退款说明

退款周期：交易发生后12个月内可发起退款，超期不可退款。

退款方式：资金原路返回用户账号。

退款退费：默认退款时手续费退回，退款手续费计算方式参考手续费收取

3.4.3、示例代码

重要入参说明
注意： 请严格按照接口文档中的参数入参，传入非接口文档中的参数是无效的，并且可能会导致请求被拦截或其它异常。

参数名	参数说明
orderNo	每次退款的唯一单号，每次退款时重新生成，与支付单号不是同一个。
reOrderNo	支付时返回的国通平台订单号，与 tOrderNo和oldTOrderNo 必填一个。
tOrderNo	支付时返回的第三方通道号，与 reOrderNo和oldTOrderNo 必填一个。
oldTOrderNo	支付时请求的三方单号，与 reOrderNo和tOrderNo 必填一个。
refundAmount	本次退款金额，不能超过订单总金额。
tag	原订单类型，传错会导致查不到订单。
originTradeDate	原交易日期，不传默认退90天内的原订单，若超过90天需传该参数。以星驿付订单创建日期为准

付款码支付

1、产品介绍#

1.1、简介#

1.2、使用步骤#

2、接入方式#

2.1、接入流程#

3、开发指引#

3.1、对接规范#

3.2、支付流程#

3.2.1、系统交互流程#

3.2.2、示例代码#

3.3、查询交易#

3.3.1、示例代码#

3.4、退款流程#

3.4.1、退款结果#

3.4.2、退款说明#

3.4.3、示例代码#