注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 电子凭证平台

taobao.eticket.merchant.ma.send (码商发码成功回调接口)

码商发码成功回调接口,目前已支持普通码商发码以及码商发卡号卡密

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
biz_type Number 可选 3001
  • 默认值:3001
  • 业务类型
    isv_ma_list IsvMa [] 可选
  • 最大列表长度:200
  • 码商发码类型certificate_type = 0时填写,需要发送的码列表
    • └ code
    • String
    • 可选
    • abc123
    • 串码码值,请注意需要回传符合规范的凭证码,certificate_type = 0时必填
    • └ num
    • Number
    • 可选
    • 1
    • 码的可核销份数,certificate_type = 0时必填
    • └ qr_image
    • String
    • 可选
    • 111.png
    • 二维码图片文件名。已经申请了上传二维码的码商必填,其它码商无需关心。这个值是taobao.eticket.merchant.img.upload调用后的file_name
    outer_id String 必须 1753340805138544 业务id(订单号)
    token String 必须 31231231231 需要跟发码通知获取到的参数一致
    isv_ka_list IsvKa 可选 码商发卡号卡密类型certificate_type = 1时填写,需要发送的卡号卡密列表
    • └ ka_no
    • String
    • 可选
    • 1a2b3c4d
    • 卡号,certificate_type = 1时必填
    • └ ka_mi
    • String
    • 可选
    • abc12345678
    • 卡密,certificate_type = 1时必填
    • └ num
    • Number
    • 可选
    • 1
    • 卡号卡密可核销份数,有特殊定制请联系电子凭证同学,默认为1,certificate_type = 1时必填
    certificate_type Number 可选 1
  • 默认值:0
  • 凭证类型,0表示普通码商发码需要填写isv_ma_list,1表示码商发卡号卡密需要填写isv_ka_list
    group_redeem Boolean 可选 true
  • 默认值:false
  • true表示兑换码组合发码,ka_mi中的code使用英文的~进行分隔。

    响应参数

    名称 类型 示例值 描述
    resp_body SendMaCallbackResp {} 回复参数
    • └ attribute_map
    • String
    • {}
    • 业务参数KV
    ret_code String isv.success-all 子结果码
    ret_msg String 操作成功 子结果信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    EticketMerchantMaSendRequest req = new EticketMerchantMaSendRequest();
    req.setBizType(3001L);
    List<EticketMerchantMaSendRequest.IsvMa> list2 = new ArrayList<EticketMerchantMaSendRequest.IsvMa>();
    EticketMerchantMaSendRequest.IsvMa obj3 = new EticketMerchantMaSendRequest.IsvMa();
    list2.add(obj3);
    obj3.setCode("abc123");
    obj3.setNum(1L);
    obj3.setQrImage("111.png");
    req.setIsvMaList(list2);
    req.setOuterId("1753340805138544");
    req.setToken("31231231231");
    EticketMerchantMaSendRequest.IsvKa obj4 = new EticketMerchantMaSendRequest.IsvKa();
    obj4.setKaNo("1a2b3c4d");
    obj4.setKaMi("abc12345678");
    obj4.setNum(1L);
    req.setIsvKaList(obj4);
    req.setCertificateType(1L);
    req.setGroupRedeem(true);
    EticketMerchantMaSendResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <eticket_merchant_ma_send_response>
        <resp_body>
            <attribute_map>{}</attribute_map>
        </resp_body>
        <ret_code>isv.success-all</ret_code>
        <ret_msg>操作成功</ret_msg>
    </eticket_merchant_ma_send_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部