业务说明

支持的交易类型:4.34网银支付、4.65快捷支付申请、4.67快捷支付页面版

交易请求报文

JSON:

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

XML:

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

交易请求报文说明

节点名称中文名称类型说明是否必填
sign报文签名String(32)请求报文格式为JSON时必填
计算签名方式请看2.1章节
可选
request_type请求类型String(32)固定值:online_query_request必填
isspid商户号String(8)翼码商户号,由翼码提供必填
pos_id终端号String(20)商户自定义终端号必填
store_id门店号String(20)商户自定义门店号必填
pos_seq查询请求流水号String(32)可空
有值时必须同一个翼码商户号下唯一,不可重复使用,且大于12位
可空
user_id操作员标识String(20)操作员号可空
system_id系统平台号String(4)由翼码提供必填
online_query_request
->org_pos_seq
支付请求流水号String(32)被查询的支付请求流水号,且大于12位必填

交易返回报文

JSON:

  1. {
  2. "response_type": "online_query_response",
  3. "isspid": "39493002",
  4. "pos_id": "8888888888",
  5. "pos_seq": "2018121400000005",
  6. "trans_time": "20181214143957",
  7. "pay_type": "517",
  8. "sys_seq": "0f041092d0ccc6ae",
  9. "memo": "订单备注",
  10. "res_info": {
  11. "trade_no": "20180504050741694554",
  12. "out_trade_no": "1805040000021",
  13. "union_trade_no": "111111111111111111",
  14. "tx_amt": 1,
  15. "unconfirm_amt": 0,
  16. "confirmed_amt": 1,
  17. "card_type": "D",
  18. "card_no": "6200000000000000001",
  19. "bank_id": "00000001",
  20. "name": "张三",
  21. "user_yima_id": "11111111111",
  22. },
  23. "result": {
  24. "id": "0000",
  25. "comment": "交易成功"
  26. },
  27. "sign": "79D928004531AE15DFA6AD7E9A6A2447"
  28. }

XML:

  1. <?xml version="1.0" encoding="GBK"?>
  2. <business_trans>
  3. <response_type>online_query_response</response_type>
  4. <isspid>39493002</isspid>
  5. <pos_id>123456789</pos_id>
  6. <pos_seq>000000000001</pos_seq>
  7. <sys_seq>000000000244</sys_seq>
  8. <trans_time>20090405010104</trans_time>
  9. <pay_type>517</pay_type>
  10. <memo>订单备注</memo>
  11. <res_info>
  12. <trade_no>2018111522001429701012895360</trade_no>
  13. <out_trade_no>1811150000001</out_trade_no>
  14. <union_trade_no>111111111111111111</union_trade_no>
  15. <tx_amt>1</tx_amt>
  16. <unconfirm_amt>0</unconfirm_amt>
  17. <confirmed_amt>1</confirmed_amt>
  18. <card_type>D</card_type>
  19. <card_no>6200000000000000001</card_no>
  20. <bank_id>00000001</bank_id>
  21. <name>张三</name>
  22. <user_yima_id>11111111111</user_yima_id>
  23. </res_info>
  24. <result>
  25. <id>0000</id>
  26. <comment>交易成功</comment>
  27. </result>
  28. </business_trans>

交易返回报文说明

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

节点名称中文名称类型说明是否必填
sign报文签名String(32)返回报文格式为JSON时必填
计算签名方式请看2.1章节
可选
response_type返回类型String(32)固定值:online_query_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)517:网银支付
518:快捷支付
必填
memo订单备注String(128)返回支付请求时内容可空
res_info
->trade_no
通道支付流水号String(64)支付交易的通道唯一流水号可空
res_info
->out_trade_no
支付商户订单号String(32)支付交易的商户订单号可空
res_info
->union_trade_no
银联网联流水号String(32)发往银联/网联的订单编号,即银联网联流水号可空
res_info
->tx_amt
交易金额String(9)单位为分可空
res_info
->unconfirm_amt
待确认总金额String(9)单位为分,仅延时交易会返回可空
res_info
->confirmed_amt
已确认总金额String(9)单位为分,仅延时交易会返回可空
res_info
->card_type
卡类型String(1)D:借记卡
C:贷记卡(信用卡)
可空
res_info
->card_no
银行卡号String(19)可空
res_info
->bank_id
银行编码String(8)取值详见【7.2 银行编码】可空
res_info
->name
持卡人姓名String(64)可空
res_info
->user_yima_id
用户号String(32)支付人的用户号可空
result
->id
响应码String(4)0000:交易成功
9998:等待付款(需要继续调用查询接口查询结果)
其它表示失败,错误信息说明见“响应码解释”字段
必填
result
->comment
响应码解释String(64)响应码对应中文注解,用于显示提示必填

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