简介

作为凭证下发必要的参数,用于区分不同商品或者活动之间的数据,并可以限制活动的使用范围(验证地点),以及使用方式。

请求报文

  1. <?xml version="1.0" encoding="GBK"?>
  2. <ActivityCreateReq>
  3. <SystemID>2200</SystemID>
  4. <ISSPID>00000061</ISSPID>
  5. <TransactionID>223331113</TransactionID>
  6. <ActivityInfo>
  7. <CustomNo>223300013</CustomNo>
  8. <ActivityName>XXX活动名称</ActivityName>
  9. <ActivityShortName>XXX活动简称</ActivityShortName>
  10. <UseRangeID>0000000112</UseRangeID>
  11. <BeginTime>20111110000000</BeginTime>
  12. <EndTime>20121210000000</EndTime>
  13. </ActivityInfo>
  14. <VerifyMode>
  15. <UseTimesLimit>1</UseTimesLimit>
  16. <UseAmtLimit>0</UseAmtLimit>
  17. </VerifyMode>
  18. <GoodsInfo>
  19. <GoodsName>XXX商品名称</GoodsName>
  20. <GoodsShortName>XXX商品简称</GoodsShortName>
  21. </GoodsInfo>
  22. <DefaultParam>
  23. <PasswordTryTimes>6</PasswordTryTimes>
  24. <PasswordType>1</PasswordType>
  25. </DefaultParam>
  26. </ActivityCreateReq>

请求参数

XML元素类型意义说明是否必填
SystemIDString(4)接入系统号支撑平台提供必填
ISSPIDString(8)业务商号支撑平台提供必填
TransactionIDString(32)凭证发送单号作为凭证唯一标识不能重复。特别注意:在未收到响应报文的情况下(超时),不能确认支撑平台是否已经处理成功,原报文应重试几次,该字段值不能改变,如改变则认为新交易。必填
ActivityInfo-> CustomNoString(32)自定义活动号可选
ActivityInfo-> ActivityNameString(100)活动详称必填
ActivityInfo-> ActivityShortNameString(24)活动简称必填
ActivityInfo-> UseRangeIDString(10)终端使用范围支撑平台提供必填
ActivityInfo-> BeginTimeString(14)活动开始时间必填
ActivityInfo-> EndTimeString(14)活动结束时间必填
VerifyMode-> UseTimesLimitChar(1)次数验证模式0- 否1- 是必填
VerifyMode-> UseAmtLimitChar(1)金额验证模式0- 否1- 是UseTimesLimit和UseAmtLimit必须有且只能一个值为1必填
GoodsInfo-> GoodsNameString(100)商品名称必填
GoodsInfo-> GoodsShortNameString(24)商品简称必填
DefaultParam-> PasswordTryTimesINTEGER密码错误允许次数可选
DefaultParam-> PasswordTypeCHAR(1)密码验证类型0-手机号后6位1-辅助码后6位2-随机密码空置时代表不启用密码验证可选

应答报文

<?xml version="1.0" encoding="GBK"?>
<ActivityCreateRes>
    <ISSPID>00000061</ISSPID>
    <TransactionID>223331113</TransactionID>
    <Status>
        <StatusCode>0000</StatusCode>
        <StatusText>成功</StatusText>
    </Status>
    <MessageID>20111219182151009812</MessageID>
    <ActivityID>11121900082</ActivityID>
</ActivityCreateRes>

应答参数

XML元素类型意义说明是否必填
ISSPIDString(8)接入SP的ID号,为翼码凭证平台的提供的业务商机构号与请求包中相同xml元素的值相同必填
TransactionIDString(32)凭证发送单号与请求包中相同xml元素的值相同必填
Status-> StatusCodeString(4)处理应答码成功为0000,非0000失败。详见:返回码说明必填
Status-> StatusTextString(512)处理应答解释详见:返回码说明必填
MessageIDString(20)信息标识由翼码支撑平台产生,失败时没有该值可选
ActivityIDString(11)活动号由翼码支撑平台产生,失败时没有该值可选