Skip to main content

码激活接口

接口用途

  • 当需要激活码时，取码方调用此接口

接口说明

  • 码表中以掩码为分表位，每查询某个码时必须有明确的码号。
  • 已撤销(作废)/使用的码不能转换为其他状态。

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
Back to top
Entity Select