文档中心 > API类目 > 银泰开放平台

alibaba.mos.card.amount.pay (储值卡消费接口)

储值卡消费接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
memo String 可选 这是备注信息 备注信息
operator_name String 必须 张三 操作员/收银机/收银员名称
operator_id String 必须 004
  • 最大长度:8
  • 操作员/收银机/收银员id
    terminal_no String 必须 501
  • 最大长度:15
  • 终端号
    pay_amount Number 必须 102 消费金额 单位分
    store_name String 必须 西选武林店 银泰门店名称
    store_no String 必须 HZ01
  • 最大长度:8
  • 银泰门店编码
    merchant_order_no String 必须 202100001
  • 最大长度:30
  • 商户原始订单号
    out_trade_no String 必须 202100001123
  • 最大长度:128
  • 商户订单号-确保商户下唯一
    card_track_two String 可选 1122333=009990 二轨信息
    card_no String 可选 1122333 卡号
    counter_id String 必须 6112345
  • 最大长度:15
  • 银泰专柜id
    counter_code String 必须 A0WSD
  • 最大长度:15
  • 银泰专柜编码

    响应参数

    名称 类型 示例值 描述
    result Result 接口返回model
    • data
    • Data
    • 返回数据model
    • └ pay_amount
    • Number
    • 103
    • 消费金额
    • └ out_trade_no
    • String
    • 222222
    • 商户订单号
    • └ trade_no
    • String
    • 11111
    • 银泰交易流水号
    • └ from_store_no
    • String
    • HZ01
    • 发卡门店号
    • └ card_type
    • String
    • C05
    • 卡类型C05-提货券/C01-双线卡
    • └ success
    • Boolean
    • true
    • 是否成功
    • └ err_code
    • String
    • demo
    • 错误码
    • └ err_message
    • String
    • demo
    • 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaMosCardAmountPayRequest req = new AlibabaMosCardAmountPayRequest();
    req.setMemo("这是备注信息");
    req.setOperatorName("张三");
    req.setOperatorId("004");
    req.setTerminalNo("501");
    req.setPayAmount(102L);
    req.setStoreName("西选武林店");
    req.setStoreNo("HZ01");
    req.setMerchantOrderNo("202100001");
    req.setOutTradeNo("202100001123");
    req.setCardTrackTwo("1122333=009990");
    req.setCardNo("1122333");
    req.setCounterId("6112345");
    req.setCounterCode("A0WSD");
    AlibabaMosCardAmountPayResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_mos_card_amount_pay_response>
        <result>
            <data>
                <pay_amount>103</pay_amount>
                <out_trade_no>222222</out_trade_no>
                <trade_no>11111</trade_no>
                <from_store_no>HZ01</from_store_no>
                <card_type>C05</card_type>
            </data>
            <success>true</success>
            <err_code>demo</err_code>
            <err_message>demo</err_message>
        </result>
    </alibaba_mos_card_amount_pay_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

    返回
    顶部