交易请求报文

JSON:

  1. {
  2. "request_type": "cash_refundquery_request",
  3. "isspid": "39493002",
  4. "pos_id": "1511300001",
  5. "store_id": "1511300001",
  6. "pos_seq": "C20200217X100000000021",
  7. "user_id": "user01",
  8. "system_id": "8888",
  9. "cash_refundquery_request": {
  10. "org_pos_seq": "C20200217X100000000010"
  11. },
  12. "sign": "79CB18BC49A4D60C457506EA4EF27C14"
  13. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <request_type>cash_refundquery_request</request_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>1511300001</pos_id>
  6. <store_id>1511300001</store_id>
  7. <pos_seq>C20200217X100000000021</pos_seq>
  8. <user_id>user01</user_id>
  9. <system_id>8888</system_id>
  10. <cash_refundquery_request>
  11. <org_pos_seq>C20200217X100000000010</org_pos_seq>
  12. </cash_refundquery_request>
  13. </business_trans>

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)固定值:cash_refundquery_request必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
store_id门店号String(20)商户自定义门店号必填
pos_seq终端流水号String(32)小于32位,且大于12位可空
user_id操作员标识String(20)操作员号可空
system_id系统平台号String(4)由翼码提供必填
cash_refundquery_request
->org_pos_seq
原现金退款流水String(32)所查询订单的请求流水号必填

交易返回报文

JSON:

  1. {
  2. "request_type": "cash_refundquery_response",
  3. "isspid": "39493002",
  4. "pos_id": "1511300001",
  5. "pos_seq": "C20200217X100000000010",
  6. "sys_seq": "b7ff9fa5bb4355e2",
  7. "trans_time": "20200701103100",
  8. "pay_type": "503",
  9. "wxpay_res_info": {
  10. "trade_no": "4001172001201604144821605495",
  11. "out_trade_no": "C20200217X100000000010",
  12. "tx_amt": "10",
  13. "status": "1",
  14. "fail_reason": "失败原因",
  15. "send_time": "20200701103100",
  16. "rcv_time": "20200701103100",
  17. "refund_time": "20200701103100",
  18. "refund_amount": "10"
  19. },
  20. "result": {
  21. "id": "0000",
  22. "comment": "查询成功"
  23. },
  24. "sign": "79CB18BC49A4D60C457506EA4EF27C14"
  25. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>cash_refundquery_response</response_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>1511300001</pos_id>
  6. <pos_seq>C20200217X100000000010</pos_seq>
  7. <sys_seq>b7ff9fa5bb4355e2</sys_seq>
  8. <trans_time>20200701103100</trans_time>
  9. <pay_type>503</pay_type>
  10. <wxpay_res_info>
  11. <trade_no>4001172001201604144821605495</trade_no>
  12. <out_trade_no>C20200217X100000000010</out_trade_no>
  13. <tx_amt>10</tx_amt>
  14. <status>1</status>
  15. <fail_reason>失败原因</fail_reason>
  16. <send_time>20200701103100</send_time>
  17. <rcv_time>20200701103100</rcv_time>
  18. <refund_time>20200701103100</refund_time>
  19. <refund_amount>10</refund_amount>
  20. </wxpay_res_info>
  21. <result>
  22. <id>0000</id>
  23. <comment>查询成功</comment>
  24. </result>
  25. </business_trans>

交易返回报文说明

标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)固定值:cash_refundquery_response必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
pos_seq终端流水号String(32)终端交易流水号,和请求报文相同可空
sys_seq随机串号String(16)随机生成串号,仅用于日志跟踪用,不保存必填
trans_time接口返回时间String(14)接口返回时间,格式:yyyyMMddHHmmss必填
pay_type渠道String(3)503:微信支付必填
result
->id
响应码String(4)翼码平台返回的处理结果
0000-申请成功
9998-申请结果未知,请再次发起查询
9990-申请失败
其它响应码为失败,错误信息说明见“响应码解释”字段
申请成功的订单具体状态请根据status节点判断
必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填
当微信渠道的时返回以下数据
wxpay_res_info
->trade_no
微信单号String(64)交易成功时候,必填可空
wxpay_res_info
->out_trade_no
商户订单号String(64)交易成功时候,必填可空
wxpay_res_info
->tx_amt
交易金额Number(9)与申请金额一致可空
wxpay_res_info
->status
状态String(1)0:待确认
6:待领取
1:成功
2:已退回
3:失败
可空
wxpay_res_info
->fail_reason
失败原因String(100)发送失败原因可空
wxpay_res_info
->send_time
发送时间String(14)格式:yyyyMMddHHmmss可空
wxpay_res_info
->rcv_time
接收时间String(14)领取红包的时间,格式:yyyyMMddHHmmss可空
wxpay_res_info
->refund_time
红包退款时间String(14)红包的退款时间(如果其未领取的退款),仅当状态为已退回时有值,格式:yyyyMMddHHmmss可空
wxpay_res_info
->refund_amount
红包退款金额Number(9)以分为单位,仅当状态为已退回时有值可空

标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!