业务说明
支持的交易类型:4.34网银支付、4.65快捷支付申请、4.67快捷支付页面版
交易请求报文
JSON:
{"request_type": "online_query_request","isspid": "39493002","pos_id": "8888888888","store_id": "8888888888","pos_seq": "2018121400000005","user_id": "user01","system_id": "8888","online_query_request": {"org_pos_seq": "2018121400000001"},"sign": "79CB18BC49A4D60C457506EA4EF27C14"}
XML:
<?xml version="1.0" encoding="GBK"?><business_trans><request_type>online_query_request</request_type><isspid>39493002</isspid><pos_id>1511300001</pos_id><store_id>1511300001</store_id><pos_seq>1511300000003</pos_seq><user_id>user01</user_id><system_id>8888</system_id><online_query_request><org_pos_seq>1511300000001</org_pos_seq></online_query_request></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:
{"response_type": "online_query_response","isspid": "39493002","pos_id": "8888888888","pos_seq": "2018121400000005","trans_time": "20181214143957","pay_type": "517","sys_seq": "0f041092d0ccc6ae","memo": "订单备注","res_info": {"trade_no": "20180504050741694554","out_trade_no": "1805040000021","union_trade_no": "111111111111111111","tx_amt": 1,"unconfirm_amt": 0,"confirmed_amt": 1,"card_type": "D","card_no": "6200000000000000001","bank_id": "00000001","name": "张三","user_yima_id": "11111111111",},"result": {"id": "0000","comment": "交易成功"},"sign": "79D928004531AE15DFA6AD7E9A6A2447"}
XML:
<?xml version="1.0" encoding="GBK"?><business_trans><response_type>online_query_response</response_type><isspid>39493002</isspid><pos_id>123456789</pos_id><pos_seq>000000000001</pos_seq><sys_seq>000000000244</sys_seq><trans_time>20090405010104</trans_time><pay_type>517</pay_type><memo>订单备注</memo><res_info><trade_no>2018111522001429701012895360</trade_no><out_trade_no>1811150000001</out_trade_no><union_trade_no>111111111111111111</union_trade_no><tx_amt>1</tx_amt><unconfirm_amt>0</unconfirm_amt><confirmed_amt>1</confirmed_amt><card_type>D</card_type><card_no>6200000000000000001</card_no><bank_id>00000001</bank_id><name>张三</name><user_yima_id>11111111111</user_yima_id></res_info><result><id>0000</id><comment>交易成功</comment></result></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) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!


