验证数据同步接口
同步机制说明:如果该笔请求报文发送超时(超时时间20秒,接入系统必须保证20秒内返回处理结果),我方会立即重试3次,如果3次皆是请求超时,则系统会更新处理结果为失败,每隔半小时重试一次失败数据,失败数据保存一个月(一个月内会不断重试),一个月后清理失败数据。
简介
用于支撑平台和接入系统间实时的验证信息同步,由支撑平台发起。根据接入系统返回报文StatusCode判断成功与失败,成功将不再回送报文。
当二维码使用状态发生改变,且该接入系统在翼码支撑平台上配置了需要返回验证数据和返回的地址时,才会发起这样的一个请求,把数据发送给接入系统。
注:如果对同一个二维码,可能会有多次验证、撤销、冲正的记录,极端情况下如果冲正记录比验证记录提前发送至接入系统的话,则由报文中的ReqSeq字段值来判断,ReqSeq字段值最大的为准,如果收到的同步ReqSeq小于之前记录的值,则不进行条码状态的更新,直接返回0000即可。
请求报文
<?xml version="1.0" encoding="GBK"?>
<VerifySyncReq>
<ISSPID>0000000001</ISSPID>
<ISSPNAME>测试</ISSPNAME>
<SpSeq>23232324</SpSeq>
<ReqSeq>1111111</ReqSeq>
<TransType>2000</TransType>
<MerchantId>2323</MerchantId>
<MerchantName>门店名称</MerchantName>
<TerminalId>3434</TerminalId>
<TerminalName>终端名称</TerminalName>
<TerminalSeq>34343423</TerminalSeq>
<ActivityID>222222</ActivityID>
<ActivityName>活动名称</ActivityName>
<PGoodsId>224242</PGoodsId>
<PGoodsName>电子合约名称</PGoodsName>
<Amt>212</Amt>
<ResiduaryAmt>0</ResiduaryAmt>
<ResiduaryTimes>0</ResiduaryTimes>
<TransTime>20110826000000</TransTime>
<Status>0</Status>
<PhoneNo>13612345678</PhoneNo>
<SpareField1></SpareField1>
<SpareField2></SpareField2>
<SpareField3></SpareField3>
<SpareField4></SpareField4>
<SpareField5></SpareField5>
</VerifySyncReq>
请求参数
XML元素 | 类型 | 意义 | 说明 | 是否必填 |
---|---|---|---|---|
ISSPID | String(8) | 业务商号 | 支撑平台为接入的业务商分配的业务商号 | 必填 |
ISSPNAME | String(100) | 业务商名称 | 必填 | |
SpSeq | String(32) | 凭证生成时单号 | 凭证生成时单号,对应凭证生成TransactionID | 必填 |
ReqSeq | String(20) | 请求流水号 | 请求流水号,每次都不同,递增,最大为最后一笔 | 必填 |
TransType | String(4) | 交易类型 | 001-验证,0002-撤销,0003-冲正 | 必填 |
MerchantId | String(8) | 商户号 | 商户号 | 必填 |
MerchantName | String(100) | 商户名称 | 商户名称 | 必填 |
TerminalId | String(10) | 终端ID | 终端ID | 必填 |
TerminalName | String(100) | 终端名称 | 终端名称 | 必填 |
TerminalSeq | String(12) | 终端流水号 | 终端流水号 | 必填 |
ActivityID | String(11) | 活动号 | 活动号 | 必填 |
ActivityName | String(100) | 活动名称 | 活动名称 | 必填 |
PGoodsId | String(10) | 电子合约号 | 电子合约号 | 必填 |
PGoodsName | String(100) | 电子合约名称 | 电子合约名称 | 必填 |
Amt | Number(8,2) | 交易金额 | 交易金额,0代表次数验证 | 必填 |
ResiduaryAmt | Number(8,2) | 剩余金额 | 条码可使用的剩余金额 | 必填 |
ResiduaryTimes | Number(6) | 剩余次数 | 条码可使用的剩余次数 | 必填 |
TransTime | String(14) | 交易时间 | YYYYMMDDHH24MISS | 必填 |
Status | Char | 条码当前状态 | 0-正常 1-撤消 2-使用中 3-已使用 | 必填 |
PhoneNo | String(11) | 接收条码的手机号 | 接收条码的手机号 | 必填 |
SpareField1 | String(1024) | 保留域1 | 系统平台号 | 可选 |
SpareField2 | String(1024) | 保留域2 | 终端原请求流水号 | 可选 |
SpareField3 | String(1024) | 保留域3 | 保留域3,留待扩展使用 | 可选 |
SpareField4 | String(1024) | 保留域4 | 保留域4,留待扩展使用 | 可选 |
SpareField5 | String(1024) | 保留域5 | 保留域5,留待扩展使用 | 可选 |
应答报文
<?xml version="1.0" encoding="GBK"?>
<VerifySyncRes>
<StatusCode>0000</StatusCode>
</VerifySyncRes>
应答参数
XML元素 | 类型 | 意义 | 说明 | 是否必填 |
---|---|---|---|---|
StatusCode | String(4) | 返回结果 | 0000-成功 其他-失败 。详见:返回码说明 | 必填 |
递送报告同步
简介
用于支撑平台和接入系统间递送报告的同步,由支撑平台发起。根据接入系统返回报文StatusCode判断成功与失败,成功将不再回送。
当二维码送达手机且返回了递送报告,且该接入系统在我方支撑平台上配置了需要返回递送报告和返回的地址时,才会发起这样的一个请求,把数据发送给接入系统。
注:如果对同一个交易请求,可能会有多次递送的记录(采用SAM发送类型),可能会回送两条递送报告,如果第一条状态是递送失败,会继续递送第二条递送报告,如果第一条递送成功则不会再送。
请求报文
<?xml version="1.0" encoding="GBK"?>
<DeliverReportSyncReq>
<ISSPID>2333333</ISSPID>
<SpSeq>222222</SpSeq>
<ReqSeq>44444</ReqSeq>
<DeliverTime>20110829000000</DeliverTime>
<DeliverStatus>0000</DeliverStatus>
<DeliverDetail>递送成功</DeliverDetail>
</DeliverReportSyncReq>
请求参数
XML元素 | 类型 | 意义 | 说明 | 是否必填 |
---|---|---|---|---|
ISSPID | String(8) | 业务商号 | 支撑平台为接入的业务商分配的业务商号 | 必填 |
SpSeq | String(32) | 交易单号 | 对应凭证生成、凭证重发中TransactionID | 必填 |
ReqSeq | String(20) | 递送请求流水号 | 递送请求流水号 | 必填 |
DeliverTime | String(14) | 递送时间 | YYYYMMDDHH24MISS | 必填 |
DeliverStatus | String(4) | 递送状态 | 短彩信网关返回的递送代码,0000为递送成功,其它为递送失败 | 必填 |
DeliverDetail | String(128) | 递送代码说明 | 递送代码中文说明 | 必填 |
应答报文
<?xml version="1.0" encoding="GBK"?>
<DeliverReportSyncRes>
<StatusCode>0000</StatusCode>
</DeliverReportSyncRes>
应答参数
XML元素 | 类型 | 意义 | 说明 | 是否必填 |
---|---|---|---|---|
StatusCode | String(4) | 返回结果 | 0000-成功 其他-失败 。详见:返回码说明 | 必填 |