码激活接口
接口用途
- 当需要
激活码时，取码方调用此接口
接口说明
- 码表中以掩码为分表位，每查询某个码时必须有明确的码号。
- 已撤销(作废)/使用的码不能转换为其他状态。
action
CodeStatusUpdate
请求参数，CHANNEL===>WHALE
| 字段 | 类型 | 是否必填 | 字段意义 | 备注 |
|---|---|---|---|---|
| requestId | String | 是 | 请求流水号 | 32个字符，用于标识唯一一笔交易 |
| code | String | 是 | 码号 | 小于22个字符 |
| codeValidDays | Number | 否 | 相对有效天数 | 除制码当天开始相应天数结束。validStart、validEnd组合与validDay、commissionDate组合可选其一，若全部填写以相对有效期优先 |
| codeValidStart | Number(14) | 否 | 码有效开始时间 | 该字段填写时，validEnd必填格式:yyyyMMddHHmmss |
| codeValidEnd | Number(14) | 否 | 码有效结束时间 | 该字段填写时，validStart必填格式:yyyyMMddHHmmss |
| activateShopNo | String(10) | 否 | 激活门店号 | |
| activateOrg | String(10) | 否 | 激活机构 | |
| purchaseOrderNum | String | 否 | 用户购买订单号 | |
| notifyType | Object<notifyType> | 否 | 激活通知类型 | |
| makeFundsChannels | Array<fundsChannel> | 否 | 资金渠道 | 针对阶梯价场景为必填 |
| makeFundsChannel | Object<makeFundsChannel> | 否 | 资金渠道 | 当需要在对账报表中体现时必填 |
| optTag | String(2) | 是 | 操作分类 | 04：激活 |
请求报文举例
{
"requestId": "20181019112535100000000000000008",
"code": "1021242013780905000",
"codeValidDays":9,
"purchaseOrderNum":"20191119192700123",
"optTag":"04"
}
返回参数，WHALE===>CHANNEL
| 字段 | 类型 | 是否必填 | 字段意义 | 备注 |
|---|---|---|---|---|
| returnCode | String | 是 | 请求返回码 | |
| returnMsg | String | 是 | 请求返回信息 | |
| data | Object<statusUpdateData> | 否 | 码状态更新返回数据 |
返回报文举例
{
"returnCode": "00",
"returnMsg": "SUCCESS",
"data": {
"tradeNo": "9e22d9a9e532435db77bccdfd8a74ee5",
"requestId": "20181019112535100000000000000008",
"currentStatus": "00",
"statusDesc": "未使用",
"updateDate":"20181019",
"updateTime":"20181019112535"
}
}失败返回报文举例
{
"returnCode": "32",
"returnMsg": "流水号重复，请调用查询接口",
"data": {}
}
No Comments