alibaba.fundplatform.cardorder.make (通知制卡商制卡)

该接口由内部定义,外部制卡商实现。当需要制卡商进行制卡操作时,将会调用该接口。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
logistics_info Struct 可选 物流信息
  • └ receiver_zip_code
  • String
  • 必须
  • 310000
  • 收件人邮编
  • └ receiver_address
  • String
  • 必须
  • 浙江省-杭州市-余杭区-五常街道文一西路969号1号楼小邮局
  • 收件人地址
  • └ receiver_number
  • String
  • 必须
  • 15512345678
  • 收件人联系方式
  • └ receiver_name
  • String
  • 必须
  • 张三
  • 收件人名称
card_product_infos Struct [] 必须
  • 最大列表长度:999
  • 卡模板信息列表
    • └ template_no
    • String
    • 必须
    • 3010030E02
    • 卡模板编号
    • └ picture_url
    • String
    • 可选
    • http://www.taobao.com/1.jpg
    • 卡外观图片地址
    • └ count
    • Number
    • 必须
    • 500
    • 当前卡模板制卡数量
    • └ par_value
    • String
    • 必须
    • 100
    • 卡面额,单元分
    • └ card_name
    • String
    • 必须
    • 猫超储值卡面额100
    • 该模板生成的卡名称
    card_order_id Number 必须 16002 子制卡单ID
    own_sign String 必须 daily 环境变量值,该字段为枚举值:daily(日常),pre(预发),online(线上)

    响应参数

    名称 类型 示例值 描述
    response Struct 返回结构体
    • └ making_card_no
    • String
    • N0001
    • 若制卡请求接收成功,返回制卡商内部对应此订单的编号。目前未实际使用,可以随意填写
    • └ result_message
    • String
    • 接口服务不可用
    • 错误详情
    • └ result_code
    • String
    • SYSTEM_ERROR
    • 错误CODE
    • └ success
    • Boolean
    • true
    • 是否调用成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaFundplatformCardorderMakeRequest req = new AlibabaFundplatformCardorderMakeRequest();
    AlibabaFundplatformCardorderMakeRequest.Struct obj1 = new AlibabaFundplatformCardorderMakeRequest.Struct();
    obj1.setReceiverZipCode("310000");
    obj1.setReceiverAddress("浙江省-杭州市-余杭区-五常街道文一西路969号1号楼小邮局");
    obj1.setReceiverNumber("15512345678");
    obj1.setReceiverName("张三");
    req.setLogisticsInfo(obj1);
    List<AlibabaFundplatformCardorderMakeRequest.Struct> list3 = new ArrayList<AlibabaFundplatformCardorderMakeRequest.Struct>();
    AlibabaFundplatformCardorderMakeRequest.Struct obj4 = new AlibabaFundplatformCardorderMakeRequest.Struct();
    list3.add(obj4);
    obj4.setTemplateNo("3010030E02");
    obj4.setPictureUrl("http://www.taobao.com/1.jpg");
    obj4.setCount(500L);
    obj4.setParValue("100");
    obj4.setCardName("猫超储值卡面额100");
    req.setCardProductInfos(list3);
    req.setCardOrderId(16002L);
    req.setOwnSign("daily");
    AlibabaFundplatformCardorderMakeResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <response>
        <making_card_no>N0001</making_card_no>
        <result_message>接口服务不可用</result_message>
        <result_code>SYSTEM_ERROR</result_code>
        <success>true</success>
    </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

    返回
    顶部