验证数据同步接口

同步机制说明:如果该笔请求报文发送超时(超时时间20秒,接入系统必须保证20秒内返回处理结果),我方会立即重试3次,如果3次皆是请求超时,则系统会更新处理结果为失败,每隔半小时重试一次失败数据,失败数据保存一个月(一个月内会不断重试),一个月后清理失败数据。

简介

用于支撑平台和接入系统间实时的验证信息同步,由支撑平台发起。根据接入系统返回报文StatusCode判断成功与失败,成功将不再回送报文。

当二维码使用状态发生改变,且该接入系统在翼码支撑平台上配置了需要返回验证数据和返回的地址时,才会发起这样的一个请求,把数据发送给接入系统。

注:如果对同一个二维码,可能会有多次验证、撤销、冲正的记录,极端情况下如果冲正记录比验证记录提前发送至接入系统的话,则由报文中的ReqSeq字段值来判断,ReqSeq字段值最大的为准,如果收到的同步ReqSeq小于之前记录的值,则不进行条码状态的更新,直接返回0000即可。

请求报文

  1. <?xml version="1.0" encoding="GBK"?>
  2. <VerifySyncReq>
  3. <ISSPID>0000000001</ISSPID>
  4. <ISSPNAME>测试</ISSPNAME>
  5. <SpSeq>23232324</SpSeq>
  6. <ReqSeq>1111111</ReqSeq>
  7. <TransType>2000</TransType>
  8. <MerchantId>2323</MerchantId>
  9. <MerchantName>门店名称</MerchantName>
  10. <TerminalId>3434</TerminalId>
  11. <TerminalName>终端名称</TerminalName>
  12. <TerminalSeq>34343423</TerminalSeq>
  13. <ActivityID>222222</ActivityID>
  14. <ActivityName>活动名称</ActivityName>
  15. <PGoodsId>224242</PGoodsId>
  16. <PGoodsName>电子合约名称</PGoodsName>
  17. <Amt>212</Amt>
  18. <ResiduaryAmt>0</ResiduaryAmt>
  19. <ResiduaryTimes>0</ResiduaryTimes>
  20. <TransTime>20110826000000</TransTime>
  21. <Status>0</Status>
  22. <PhoneNo>13612345678</PhoneNo>
  23. <SpareField1></SpareField1>
  24. <SpareField2></SpareField2>
  25. <SpareField3></SpareField3>
  26. <SpareField4></SpareField4>
  27. <SpareField5></SpareField5>
  28. </VerifySyncReq>

请求参数

XML元素类型意义说明是否必填
ISSPIDString(8)业务商号支撑平台为接入的业务商分配的业务商号必填
ISSPNAMEString(100)业务商名称必填
SpSeqString(32)凭证生成时单号凭证生成时单号,对应凭证生成TransactionID必填
ReqSeqString(20)请求流水号请求流水号,每次都不同,递增,最大为最后一笔必填
TransTypeString(4)交易类型001-验证,0002-撤销,0003-冲正必填
MerchantIdString(8)商户号商户号必填
MerchantNameString(100)商户名称商户名称必填
TerminalIdString(10)终端ID终端ID必填
TerminalNameString(100)终端名称终端名称必填
TerminalSeqString(12)终端流水号终端流水号必填
ActivityIDString(11)活动号活动号必填
ActivityNameString(100)活动名称活动名称必填
PGoodsIdString(10)电子合约号电子合约号必填
PGoodsNameString(100)电子合约名称电子合约名称必填
AmtNumber(8,2)交易金额交易金额,0代表次数验证必填
ResiduaryAmtNumber(8,2)剩余金额条码可使用的剩余金额必填
ResiduaryTimesNumber(6)剩余次数条码可使用的剩余次数必填
TransTimeString(14)交易时间YYYYMMDDHH24MISS必填
StatusChar条码当前状态0-正常 1-撤消 2-使用中 3-已使用必填
PhoneNoString(11)接收条码的手机号接收条码的手机号必填
SpareField1String(1024)保留域1系统平台号可选
SpareField2String(1024)保留域2终端原请求流水号可选
SpareField3String(1024)保留域3保留域3,留待扩展使用可选
SpareField4String(1024)保留域4保留域4,留待扩展使用可选
SpareField5String(1024)保留域5保留域5,留待扩展使用可选

应答报文

<?xml version="1.0" encoding="GBK"?>
<VerifySyncRes>
    <StatusCode>0000</StatusCode>
</VerifySyncRes>

应答参数

XML元素类型意义说明是否必填
StatusCodeString(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元素类型意义说明是否必填
ISSPIDString(8)业务商号支撑平台为接入的业务商分配的业务商号必填
SpSeqString(32)交易单号对应凭证生成、凭证重发中TransactionID必填
ReqSeqString(20)递送请求流水号递送请求流水号必填
DeliverTimeString(14)递送时间YYYYMMDDHH24MISS必填
DeliverStatusString(4)递送状态短彩信网关返回的递送代码,0000为递送成功,其它为递送失败必填
DeliverDetailString(128)递送代码说明递送代码中文说明必填

应答报文

<?xml version="1.0" encoding="GBK"?>
<DeliverReportSyncRes>
    <StatusCode>0000</StatusCode>
</DeliverReportSyncRes>

应答参数

XML元素类型意义说明是否必填
StatusCodeString(4)返回结果0000-成功 其他-失败 。详见:返回码说明必填