业务说明
支持的交易类型: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) | 响应码对应中文注解,用于显示提示 | 必填 |
标准接口会因业务升级需要而新增节点,请在解析返回报文时避免新增未知节点产生的程序出错!