简介
作为凭证下发必要的参数,用于区分不同商品或者活动之间的数据,并可以限制活动的使用范围(验证地点),以及使用方式。
请求报文
<?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) | 活动号 | 由翼码支撑平台产生,失败时没有该值 | 可选 |