简介
作为凭证下发必要的参数,用于区分不同商品或者活动之间的数据,并可以限制活动的使用范围(验证地点),以及使用方式。
请求报文
<?xml version="1.0" encoding="GBK"?>
<ActivityCreateReq>
<SystemID>2200</SystemID>
<ISSPID>00000061</ISSPID>
<TransactionID>223331113</TransactionID>
<ActivityInfo>
<CustomNo>223300013</CustomNo>
<ActivityName>XXX活动名称</ActivityName>
<ActivityShortName>XXX活动简称</ActivityShortName>
<UseRangeID>0000000112</UseRangeID>
<BeginTime>20111110000000</BeginTime>
<EndTime>20121210000000</EndTime>
</ActivityInfo>
<VerifyMode>
<UseTimesLimit>1</UseTimesLimit>
<UseAmtLimit>0</UseAmtLimit>
</VerifyMode>
<GoodsInfo>
<GoodsName>XXX商品名称</GoodsName>
<GoodsShortName>XXX商品简称</GoodsShortName>
</GoodsInfo>
<DefaultParam>
<PasswordTryTimes>6</PasswordTryTimes>
<PasswordType>1</PasswordType>
</DefaultParam>
</ActivityCreateReq>
请求参数
XML元素 | 类型 | 意义 | 说明 | 是否必填 |
---|
SystemID | String(4) | 接入系统号 | 支撑平台提供 | 必填 |
ISSPID | String(8) | 业务商号 | 支撑平台提供 | 必填 |
TransactionID | String(32) | 凭证发送单号 | 作为凭证唯一标识不能重复。特别注意:在未收到响应报文的情况下(超时),不能确认支撑平台是否已经处理成功,原报文应重试几次,该字段值不能改变,如改变则认为新交易。 | 必填 |
ActivityInfo-> CustomNo | String(32) | 自定义活动号 | | 可选 |
ActivityInfo-> ActivityName | String(100) | 活动详称 | | 必填 |
ActivityInfo-> ActivityShortName | String(24) | 活动简称 | | 必填 |
ActivityInfo-> UseRangeID | String(10) | 终端使用范围 | 支撑平台提供 | 必填 |
ActivityInfo-> BeginTime | String(14) | 活动开始时间 | | 必填 |
ActivityInfo-> EndTime | String(14) | 活动结束时间 | | 必填 |
VerifyMode-> UseTimesLimit | Char(1) | 次数验证模式 | 0- 否1- 是 | 必填 |
VerifyMode-> UseAmtLimit | Char(1) | 金额验证模式 | 0- 否1- 是UseTimesLimit和UseAmtLimit必须有且只能一个值为1 | 必填 |
GoodsInfo-> GoodsName | String(100) | 商品名称 | | 必填 |
GoodsInfo-> GoodsShortName | String(24) | 商品简称 | | 必填 |
DefaultParam-> PasswordTryTimes | INTEGER | 密码错误允许次数 | | 可选 |
DefaultParam-> PasswordType | CHAR(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元素 | 类型 | 意义 | 说明 | 是否必填 |
---|
ISSPID | String(8) | 接入SP的ID号,为翼码凭证平台的提供的业务商机构号 | 与请求包中相同xml元素的值相同 | 必填 |
TransactionID | String(32) | 凭证发送单号 | 与请求包中相同xml元素的值相同 | 必填 |
Status-> StatusCode | String(4) | 处理应答码 | 成功为0000,非0000失败。详见:返回码说明 | 必填 |
Status-> StatusText | String(512) | 处理应答解释 | 详见:返回码说明 | 必填 |
MessageID | String(20) | 信息标识 | 由翼码支撑平台产生,失败时没有该值 | 可选 |
ActivityID | String(11) | 活动号 | 由翼码支撑平台产生,失败时没有该值 | 可选 |