退款 (扫码、银行卡、扫脸)

退款 (扫码、银行卡、扫脸) 退款交易包括 (消费撤销、预授权撤销、预授权完成撤销)

说明: 如果退款时因网络原因遇到超时(应答码Q02),可尝试通过单笔交易查询接口 查询退款状态.

Request

数据项数据类型(默认String)标识是否必填(M/C)说明适用范围
应用类型StringappTypeC00:银行卡应用01:聚合扫码支付应用02:银行卡+银联扫码支付应用51:刷脸支付扫码、银行卡、扫脸
应用IdStringappIdM应用包名,android APP程序packagename扫码、银行卡、扫脸
交易类型StringtransTypeM09-退款扫码、银行卡、扫脸
退款金额LongamountC单位为分,1元表示为100L,最多12位,传空则退全款扫码、银行卡、扫脸
Saas系统退款单号StringorderIdM1.Saas系统的支付订单号(字符串),用于标识当笔交易的支付订单号,交易处理结果中会带回。2.业务订单号与支付订单号的关系:一个业务订单号可以对应多个支付订单号,比如用户买了一件商品后会产生一个业务订单号和一个消费支付订单号,用户将此商品退款后又会产生一个退款的支付订单号。3.如果Saas业务系统中业务订单号与支付订单号是一对一的关系或者没有支付订单号的情况那么两个订单号都填写业务订单号即可。4.推荐不要超过32位扫码、银行卡、扫脸
Saas系统业务订单号StringbusinessIdM1.Saas系统的业务订单号(字符串,不包含特殊字符),用于标识当笔交易属于哪一笔业务订单,交易处理结果中会带回。2.业务订单号与支付订单号的关系:一个业务订单号可以对应多个支付订单号,比如用户买了一件商品后会产生一个业务订单号和一个消费支付订单号,用户将此商品退款后又会产生一个退款的支付订单号。3.如果Saas业务系统中业务订单号与支付订单号是一对一的关系或者没有支付订单号的情况那么两个订单号都填写业务订单号即可。4.最多50个字符长度扫码、银行卡、扫脸
原收银台流水号StringoriMisId特殊选项特殊选项N选一扫码、银行卡、扫脸
原Saas系统支付订单号StringoriOrderId特殊选项特殊选项N选一扫码、银行卡、扫脸
原商户(平台)订单号StringoriPlatformId特殊选项特殊选项N选一扫码、银行卡、扫脸
配置参数(UI、打印等参数配置)ConfigconfigC配置UI、打印等参数扫码、扫脸
交易过程中是否播报语音BooleanvoiceBroadcast(Config字段)Ctrue:播报语音;false:不播放语音注意: 1.扫码交易前金额播报、扫码交易结果播报,刷脸交易没有金额和交易结果语音播报2.默认以收银台设置的开关为准3.此参数对金融设备无效,扫码
是否打印小票BooleanprintTicket(Config字段)C为true时打印;为false时不打印;默认打印(兼容老字段)扫码、银行卡、扫脸
指定签购单上的退款订单号类型StringprintIdType(Config字段)C订单类型:“mis”:收银台水号;“order”:Saas软件订单号“platform”商户(第三方)订单号:不传值时默认不打印,参数值传错则返回参数错误扫码、扫脸
备注StringRemarks(Config字段)C打印小票上的备注(200个字符以内)扫码、扫脸

Response

数据项数据类型(默认String)标识是否必填(M/C)说明适用范围
交易结果返回码StringresultCodeMT00:成功非T00:失败, 见返回码定义(附录B)扫码、银行卡、扫脸
返回码描述StringresultMsgC 扫码、银行卡、扫脸
应用类型StringappTypeC00:银行卡应用01:聚合扫码支付应用02:银行卡+银联扫码支付应用51:刷脸支付扫码、银行卡、扫脸
交易类型StringtransTypeM09-退款扫码、银行卡、扫脸
收银台流水号StringmisIdM用于标识当笔交易的订单号,交易处理结果中会带回。扫码、银行卡、扫脸
Saas系统退款单号StringorderIdM1.Saas系统的支付订单号(字符串,不包含特殊字符),用于标识当笔交易的支付订单号,交易处理结果中会带回。2.业务订单号与支付订单号的关系:一个业务订单号可以对应多个支付订单号,比如用户买了一件商品后会产生一个业务订单号和一个消费支付订单号,用户将此商品退款后又会产生一个退款的支付订单号。3.如果Saas业务系统中业务订单号与支付订单号是一对一的关系或者没有支付订单号的情况那么两个订单号都填写业务订单号即可。扫码、银行卡、扫脸
Saas系统业务订单号StringbusinessIdM1.Saas系统的业务订单号(字符串,不包含特殊字符),用于标识当笔交易属于哪一笔业务订单,交易处理结果中会带回。2.业务订单号与支付订单号的关系:一个业务订单号可以对应多个支付订单号,比如用户买了一件商品后会产生一个业务订单号和一个消费支付订单号,用户将此商品退款后又会产生一个退款的支付订单号。3.如果Saas业务系统中业务订单号与支付订单号是一对一的关系或者没有支付订单号的情况那么两个订单号都填写业务订单号即可。扫码、银行卡、扫脸
原Saas软件订单号StringoriOrderIdC 扫码、银行卡、扫脸
原收银台流水号StringoriMisIdM 扫码、银行卡、扫脸
商户(第三方平台)订单号StringplatformIdC商户(第三方平台)订单号(微信、支付宝客户端显示的订单号,银行卡交易则返回系统参考号)扫码、银行卡、扫脸
支付方式StringplatformMwxpay:微信支付alipay:支付宝支付unionpay:银联钱包支付card:银行卡支付扫码、银行卡、扫脸
交易金额LongamountM单位为分,1元表示为100L扫码、银行卡、扫脸
交易日期StringtransDateC格式“MMdd” 扫码、银行卡、扫脸
交易时间StringtransTimeC格式“HHmmss” 扫码、银行卡、扫脸
凭证号StringvoucherNumC撤销、查询、打印使用银行卡
批次号StringbatchNumC 银行卡
系统参考号StringreferenceNumC部分业务退货使用银行卡
卡号StringcardNumC脱敏处理规则:除前六位和后四位之外其余位变*号处理。银行卡
发卡行StringissuerC 银行卡
收单行StringacquirerC 银行卡
操作员号StringoperatorIdC 银行卡
卡类型StringcardTypeCIC、NFC、MAG银行卡
账户类型StringaccountTypeC“OA”:扫码”CC”:贷记卡
“DC”:借记卡
“SCC”:准贷记卡”EC”:电子现金
“MAG”:磁条卡
“VC”:Visa卡
“MC”:MasterCard 万事达卡
“AE”:美国运通卡
“JCB”:JCB卡是源自日本的世界通用国际信用”RPC”:RuPay(India)印度卡
银行卡
机型StringmodelCPOS外设型号银行卡
版本StringversionCPOS应用版本扫码、银行卡、扫脸
终端号StringterminalIdC 扫码、银行卡、扫脸
商户号StringmerchantIdC 扫码、银行卡、扫脸