退款 (扫码、银行卡、扫脸) 退款交易包括 (消费撤销、预授权撤销、预授权完成撤销)
说明: 如果退款时因网络原因遇到超时(应答码Q02),可尝试通过单笔交易查询接口 查询退款状态.
Request
数据项 | 数据类型(默认String) | 标识 | 是否必填(M/C) | 说明 | 适用范围 | |
应用类型 | String | appType | C | 00:银行卡应用01:聚合扫码支付应用02:银行卡+银联扫码支付应用51:刷脸支付 | 扫码、银行卡、扫脸 | |
应用Id | String | appId | M | 应用包名,android APP程序packagename | 扫码、银行卡、扫脸 | |
交易类型 | String | transType | M | 09-退款 | 扫码、银行卡、扫脸 | |
退款金额 | Long | amount | C | 单位为分,1元表示为100L,最多12位,传空则退全款 | 扫码、银行卡、扫脸 | |
Saas系统退款单号 | String | orderId | M | 1.Saas系统的支付订单号(字符串),用于标识当笔交易的支付订单号,交易处理结果中会带回。2.业务订单号与支付订单号的关系:一个业务订单号可以对应多个支付订单号,比如用户买了一件商品后会产生一个业务订单号和一个消费支付订单号,用户将此商品退款后又会产生一个退款的支付订单号。3.如果Saas业务系统中业务订单号与支付订单号是一对一的关系或者没有支付订单号的情况那么两个订单号都填写业务订单号即可。4.推荐不要超过32位 | 扫码、银行卡、扫脸 | |
Saas系统业务订单号 | String | businessId | M | 1.Saas系统的业务订单号(字符串,不包含特殊字符),用于标识当笔交易属于哪一笔业务订单,交易处理结果中会带回。2.业务订单号与支付订单号的关系:一个业务订单号可以对应多个支付订单号,比如用户买了一件商品后会产生一个业务订单号和一个消费支付订单号,用户将此商品退款后又会产生一个退款的支付订单号。3.如果Saas业务系统中业务订单号与支付订单号是一对一的关系或者没有支付订单号的情况那么两个订单号都填写业务订单号即可。4.最多50个字符长度 | 扫码、银行卡、扫脸 | |
原收银台流水号 | String | oriMisId | 特殊选项 | 特殊选项N选一 | 扫码、银行卡、扫脸 | |
原Saas系统支付订单号 | String | oriOrderId | 特殊选项 | 特殊选项N选一 | 扫码、银行卡、扫脸 | |
原商户(平台)订单号 | String | oriPlatformId | 特殊选项 | 特殊选项N选一 | 扫码、银行卡、扫脸 | |
配置参数(UI、打印等参数配置) | Config | config | C | 配置UI、打印等参数 | 扫码、扫脸 | |
交易过程中是否播报语音 | Boolean | voiceBroadcast(Config字段) | C | true:播报语音;false:不播放语音注意: 1.扫码交易前金额播报、扫码交易结果播报,刷脸交易没有金额和交易结果语音播报2.默认以收银台设置的开关为准3.此参数对金融设备无效, | 扫码 | |
是否打印小票 | Boolean | printTicket(Config字段) | C | 为true时打印;为false时不打印;默认打印(兼容老字段) | 扫码、银行卡、扫脸 | |
指定签购单上的退款订单号类型 | String | printIdType(Config字段) | C | 订单类型:“mis”:收银台流水号;“order”:Saas软件订单号;“platform”:商户(第三方)订单号:不传值时默认不打印,参数值传错则返回参数错误 | 扫码、扫脸 | |
备注 | String | Remarks(Config字段) | C | 打印小票上的备注(200个字符以内) | 扫码、扫脸 |
Response
数据项 | 数据类型(默认String) | 标识 | 是否必填(M/C) | 说明 | 适用范围 |
交易结果返回码 | String | resultCode | M | T00:成功非T00:失败, 见返回码定义(附录B) | 扫码、银行卡、扫脸 |
返回码描述 | String | resultMsg | C | 扫码、银行卡、扫脸 | |
应用类型 | String | appType | C | 00:银行卡应用01:聚合扫码支付应用02:银行卡+银联扫码支付应用51:刷脸支付 | 扫码、银行卡、扫脸 |
交易类型 | String | transType | M | 09-退款 | 扫码、银行卡、扫脸 |
收银台流水号 | String | misId | M | 用于标识当笔交易的订单号,交易处理结果中会带回。 | 扫码、银行卡、扫脸 |
Saas系统退款单号 | String | orderId | M | 1.Saas系统的支付订单号(字符串,不包含特殊字符),用于标识当笔交易的支付订单号,交易处理结果中会带回。2.业务订单号与支付订单号的关系:一个业务订单号可以对应多个支付订单号,比如用户买了一件商品后会产生一个业务订单号和一个消费支付订单号,用户将此商品退款后又会产生一个退款的支付订单号。3.如果Saas业务系统中业务订单号与支付订单号是一对一的关系或者没有支付订单号的情况那么两个订单号都填写业务订单号即可。 | 扫码、银行卡、扫脸 |
Saas系统业务订单号 | String | businessId | M | 1.Saas系统的业务订单号(字符串,不包含特殊字符),用于标识当笔交易属于哪一笔业务订单,交易处理结果中会带回。2.业务订单号与支付订单号的关系:一个业务订单号可以对应多个支付订单号,比如用户买了一件商品后会产生一个业务订单号和一个消费支付订单号,用户将此商品退款后又会产生一个退款的支付订单号。3.如果Saas业务系统中业务订单号与支付订单号是一对一的关系或者没有支付订单号的情况那么两个订单号都填写业务订单号即可。 | 扫码、银行卡、扫脸 |
原Saas软件订单号 | String | oriOrderId | C | 扫码、银行卡、扫脸 | |
原收银台流水号 | String | oriMisId | M | 扫码、银行卡、扫脸 | |
商户(第三方平台)订单号 | String | platformId | C | 商户(第三方平台)订单号(微信、支付宝客户端显示的订单号,银行卡交易则返回系统参考号) | 扫码、银行卡、扫脸 |
支付方式 | String | platform | M | wxpay:微信支付alipay:支付宝支付unionpay:银联钱包支付card:银行卡支付 | 扫码、银行卡、扫脸 |
交易金额 | Long | amount | M | 单位为分,1元表示为100L | 扫码、银行卡、扫脸 |
交易日期 | String | transDate | C | 格式“MMdd” | 扫码、银行卡、扫脸 |
交易时间 | String | transTime | C | 格式“HHmmss” | 扫码、银行卡、扫脸 |
凭证号 | String | voucherNum | C | 撤销、查询、打印使用 | 银行卡 |
批次号 | String | batchNum | C | 银行卡 | |
系统参考号 | String | referenceNum | C | 部分业务退货使用 | 银行卡 |
卡号 | String | cardNum | C | 脱敏处理规则:除前六位和后四位之外其余位变*号处理。 | 银行卡 |
发卡行 | String | issuer | C | 银行卡 | |
收单行 | String | acquirer | C | 银行卡 | |
操作员号 | String | operatorId | C | 银行卡 | |
卡类型 | String | cardType | C | IC、NFC、MAG | 银行卡 |
账户类型 | String | accountType | C | “OA”:扫码”CC”:贷记卡 “DC”:借记卡 “SCC”:准贷记卡”EC”:电子现金 “MAG”:磁条卡 “VC”:Visa卡 “MC”:MasterCard 万事达卡 “AE”:美国运通卡 “JCB”:JCB卡是源自日本的世界通用国际信用”RPC”:RuPay(India)印度卡 | 银行卡 |
机型 | String | model | C | POS外设型号 | 银行卡 |
版本 | String | version | C | POS应用版本 | 扫码、银行卡、扫脸 |
终端号 | String | terminalId | C | 扫码、银行卡、扫脸 | |
商户号 | String | merchantId | C | 扫码、银行卡、扫脸 |