alibaba.damai.mz.order.render (确认订单页渲染API)

麦座-自建电商网站-确认订单页渲染API; 1、购物车页、确认订单页 可调用此接口计算商品价格、运费价格、返回可使用的订单优惠、优惠码优惠。 2、注意:礼品卡只允许全额抵扣;不能只使用单张礼品卡的一部分余额;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param OrderRenderParam 必须 确认订单页渲染入参
  • render_goods_list
  • RenderGoods4c []
  • 必须
  • 购买的商品信息(单票维度);一单最多20张票;无座或有座下单此项必填;所购买商品的所属场次取票方式、实名制限购方式必须一致(交集);
  • └ seat_id
  • String
  • 可选
  • 93848215304
  • 座位id;有座下单必传
  • └ price_id
  • String
  • 必须
  • 937491013
  • 单票票档id
  • └ event_id
  • String
  • 可选
  • 7461828315230
  • 场次id
  • └ order_promotion_rule_id
  • String
  • 可选
  • 19273
  • 选中的订单优惠规则id;可空;不传时API会返回购买的商品可以使用的订单优惠列表
  • └ mz_user_id
  • String
  • 可选
  • 8293090023
  • 麦座用户id;必传;
  • └ coupon_code
  • String
  • 可选
  • ua3sk83781h13
  • 选中的优惠码;可空;不传时API会返回购买的商品可以使用的优惠码优惠
  • └ order_promotion_id
  • String
  • 可选
  • 289397471201
  • 选中的订单优惠id;可空;不传时此API会返回购买的商品可以使用的订单优惠列表
  • └ address_id
  • String
  • 可选
  • 14131367
  • 收货地址id;expressUseBoolean=true时,非空;收货人以收货地址id对应的收货信息为准;
  • └ express_pay_type
  • Number
  • 可选
  • 1
  • 运费支付类型;1=在线支付;expressUseBoolean=true时,非空;
  • └ express_use_boolean
  • Boolean
  • 可选
  • true
  • 是否使用快递并计算运费;true=是,false=否;
  • └ use_point
  • Number
  • 可选
  • 1000
  • 使用积分值;单位:点数
  • └ use_point_money_fen
  • Number
  • 可选
  • 1000
  • 使用积分金额;单位:分;usePoint非空时必填
  • └ use_account_money_fen
  • Number
  • 可选
  • 5000
  • 使用账户余额金额;单位:分
  • └ use_card_id
  • String
  • 可选
  • 9198129013
  • 使用礼品卡支付的卡id;
  • └ use_card_money_fen
  • Number
  • 可选
  • 1000
  • 使用礼品卡支付金额;单位:分;useCardId非空时必填

响应参数

名称 类型 示例值 描述
result ResultData api返回结果
  • └ msg
  • String
  • 成功
  • 提示
  • └ code
  • String
  • 200
  • 状态码
  • data
  • OrderRenderVO
  • 确认订单页渲染出参
  • └ total_promotion_money_fen
  • Number
  • 8000
  • 所有优惠总金额(套票、票品优惠、订单优惠、优惠码优惠);单位:分
  • └ goods_receive_money_fen
  • Number
  • 20000
  • 所有商品应收金额;原价-优惠金额+运费;单位:分;备注:此金额即为 下单接口中订单应收金额;
  • └ goods_original_total_money_fen
  • Number
  • 28000
  • 所有商品原价总金额;单位:分
  • └ coupon_code_promotion_money_fen
  • Number
  • 3500
  • 优惠码优惠金额;单位:分
  • └ coupon_code
  • String
  • ua3sk83781h13
  • 选中的优惠码;可空;
  • └ order_promotion_money_fen
  • Number
  • 2000
  • 订单优惠金额(不包括票品级别的优惠);单位:分
  • └ order_promotion_rule_id
  • String
  • 839391012331
  • 选中的订单优惠规则id;可空;
  • └ order_promotion_id
  • String
  • 8393910123
  • 选中的订单优惠id;可空;
  • coupon_code_promotion_list
  • RenderCouponCodePromotion []
  • 可用的优惠码列表;不选中优惠码优惠时返回;
  • └ promotion_name
  • String
  • 满100-30
  • 优惠名称;
  • └ coupon_code
  • String
  • ua3sk83781h13
  • 优惠码;
  • └ coupon_code_promotion_rule_id
  • String
  • 131341445
  • 优惠码优惠规则id;
  • └ promotion_show_info
  • String
  • 满100-30元
  • 优惠展示信息
  • order_promotion_list
  • RenderOrderPromotion []
  • 可用的订单优惠列表;不选中订单优惠时返回;
  • └ promotion_name
  • String
  • 满100-20
  • 优惠名称
  • └ order_promotion_rule_id
  • String
  • 8387419901
  • 订单优惠规则id;
  • └ order_promotion_id
  • String
  • 37647181912
  • 订单优惠id;
  • └ promotion_show_info
  • String
  • 满100-20元
  • 优惠展示信息
  • render_goods_list
  • RenderGoodsVO []
  • 购买的商品信息(单票维度);
  • └ real_name_buy_type
  • Number
  • 1
  • 实名制购票限制类型;1=不实名购票,2=一票一证;3=一单一证
  • └ goods_count
  • Number
  • 2
  • 商品数量;无座时三张票 = priceId*3,goodsCount=3
  • child_goods_list
  • RenderChildGoods []
  • 商品信息(单票)
  • └ event_id
  • String
  • 7461828315230
  • 场次id
  • └ price_type
  • Number
  • 1
  • 票档类型;1=单票
  • └ price_id
  • String
  • 9374910134
  • 单票票档id
  • └ goods_count
  • Number
  • 1
  • 商品数量;默认=1
  • └ seat_id
  • String
  • 93848215304
  • 座位id;
  • └ real_name_buy_type
  • Number
  • 1
  • 实名制购票限制类型;1=不实名购票,2=一票一证;3=一单一证
  • └ price_name
  • String
  • 180元
  • 票档名称
  • └ project_id
  • String
  • 91828731231
  • 项目id
  • └ project_name
  • String
  • 乌龙山伯爵
  • 项目名称
  • └ project_img_url
  • String
  • https://xxx.jpg
  • 项目图片
  • └ event_name
  • String
  • 2020-11-01 18:00
  • 场次名称
  • └ event_start_time
  • String
  • 2020-11-01 18:00
  • 场次演出开始时间;精确到分,格式:yyyy-MM-dd HH:mm
  • └ event_end_time
  • String
  • 2020-11-01 20:00
  • 场次演出结束时间;精确到分,格式:yyyy-MM-dd HH:mm
  • └ price_fen
  • Number
  • 18000
  • 票档金额/套票金额;单位:分
  • └ real_price_fen
  • Number
  • 18000
  • 减去优惠后的金额;单位:分
  • └ venue_name
  • String
  • 北京世纪剧院
  • 场馆名称;有座单票时非空
  • └ floor_name
  • String
  • 1楼
  • 楼层名称;有座单票时非空
  • └ stand_name
  • String
  • 1区
  • 看台名称,例:1区;有座单票时非空
  • └ row_name
  • String
  • 11排
  • 排名称;有座单票时非空
  • └ seat_name
  • String
  • 9号
  • 座位号名称;有座单票时非空
  • └ project_id
  • String
  • 128371892313
  • 项目id
  • └ project_name
  • String
  • 乌龙山伯爵
  • 项目名称
  • └ project_img_url
  • String
  • https://xxx.jpg
  • 项目图片
  • └ event_id
  • String
  • 7461828315230
  • 场次id
  • └ event_name
  • String
  • 2020-11-01 18:00
  • 场次名称
  • └ event_start_time
  • String
  • 2020-11-01 18:00
  • 场次演出开始时间;精确到分,格式:yyyy-MM-dd HH:mm
  • └ event_end_time
  • String
  • 2020-11-01 20:00
  • 场次演出结束时间;精确到分,格式:yyyy-MM-dd HH:mm
  • └ price_id
  • String
  • 937491013
  • 票档id;priceType=2时为套票票档id
  • └ price_name
  • String
  • 快速通道票
  • 票档名称
  • └ price_type
  • Number
  • 2
  • 票档类型;1=单票,2=套票
  • └ price_fen
  • Number
  • 18000
  • 票档金额/套票金额;单位:分
  • └ real_price_fen
  • Number
  • 18000
  • 减去优惠后的金额;单位:分
  • └ seat_id
  • String
  • 93848215304
  • 座位id;有座下单必传
  • └ venue_name
  • String
  • 北京世纪剧院
  • 场馆名称;有座单票时非空
  • └ floor_name
  • String
  • 1楼
  • 楼层名称;有座单票时非空
  • └ stand_name
  • String
  • 1区
  • 看台名称,例:1区;有座单票时非空
  • └ row_name
  • String
  • 11排
  • 排名称;有座单票时非空
  • └ seat_name
  • String
  • 8号
  • 座位号名称;有座单票时非空
  • └ mz_user_id
  • String
  • 8293090023
  • 麦座用户id;
  • └ price_promotion_money_fen
  • Number
  • 9000
  • 票品优惠金额;麦座侧自动计算;
  • └ coupon_code_promotion_rule_id
  • String
  • 2928371741
  • 优惠码优惠规则id;
  • └ express_money_fen
  • Number
  • 1000
  • 快递费;单位:分
  • └ need_online_pay
  • String
  • true
  • 是否需要在线支付,下单时若使用余额、积分、礼品卡抵扣完整单金额则不需要在线支付;
  • └ online_payment_money_fen
  • String
  • 18000
  • 需在线支付的金额; 订单应收金额 - 积分抵扣的金额 - 使用余额支付的金额 - 礼品卡抵扣金额;单位:分
  • customer_point_info
  • CustomerPointInfo
  • 会员积分信息;
  • └ able_deduct_point_money_fen
  • Number
  • 10000
  • 本单可用于抵扣的金额;单位:分
  • └ able_deduct_point
  • Number
  • 10000
  • 本单可用于抵扣的积分;单位:点数
  • └ customer_total_point
  • Number
  • 50000
  • 用户总积分;单位:点数
  • └ use_point
  • String
  • 10000
  • 使用积分值;单位:点数
  • └ use_point_money_fen
  • String
  • 10000
  • 使用积分金额;单位:分
  • customer_account_info
  • CustomerAccountInfo
  • 会员账户余额信息
  • └ able_deduct_account_money_fen
  • Number
  • 180000
  • 可用于抵扣的余额金额;单位:分
  • └ account_money_fen
  • Number
  • 180000
  • 账户总余额;
  • └ use_account_money_fen
  • Number
  • 10000
  • 使用账户余额金额;单位:分
  • card_list
  • Card []
  • 会员可用的卡列表;
  • └ card_balance_money_fen
  • Number
  • 20000
  • 卡余额金额;单位:分
  • └ card_balance_point
  • Number
  • 20000
  • 卡剩余点数 单位:点数
  • └ card_init_point
  • Number
  • 30000
  • 卡初始点数;单位:点数
  • └ card_state
  • Number
  • 1
  • 卡状态;1=已启用/激活,2=已禁用,3=已过期,4=已废除
  • └ card_no
  • String
  • yx717828h1213
  • 卡号
  • └ card_type
  • Number
  • 1
  • 卡类型;1=礼品卡
  • └ card_id
  • String
  • 12981871714
  • 卡id
  • └ use_card_id
  • String
  • 12981871714
  • 使用的卡id;
  • └ use_card_money_fen
  • Number
  • 10000
  • 使用卡金额;单位:分
  • └ able_delivery_type_list
  • Number []
  • 2,3,4
  • 取票方式list;2=身份证自助换票(换纸质票),3=取票码自助换票(换纸质票),4=二维码自助换票(换纸质票),6=二维码电子票(无纸质票),7=快递;一个场次可同时支持多种取票方式,但下单只能选择一种
  • └ success
  • Boolean
  • true
  • api请求是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzOrderRenderRequest req = new AlibabaDamaiMzOrderRenderRequest();
AlibabaDamaiMzOrderRenderRequest.OrderRenderParam obj1 = new AlibabaDamaiMzOrderRenderRequest.OrderRenderParam();
List<AlibabaDamaiMzOrderRenderRequest.RenderGoods4c> list3 = new ArrayList<AlibabaDamaiMzOrderRenderRequest.RenderGoods4c>();
AlibabaDamaiMzOrderRenderRequest.RenderGoods4c obj4 = new AlibabaDamaiMzOrderRenderRequest.RenderGoods4c();
list3.add(obj4);
obj4.setSeatId("93848215304");
obj4.setPriceId("937491013");
obj4.setEventId("7461828315230");
obj1.setRenderGoodsList(list3);
obj1.setOrderPromotionRuleId("19273");
obj1.setMzUserId("8293090023");
obj1.setCouponCode("ua3sk83781h13");
obj1.setOrderPromotionId("289397471201");
obj1.setAddressId("14131367");
obj1.setExpressPayType(1L);
obj1.setExpressUseBoolean(true);
obj1.setUsePoint(1000L);
obj1.setUsePointMoneyFen(1000L);
obj1.setUseAccountMoneyFen(5000L);
obj1.setUseCardId("9198129013");
obj1.setUseCardMoneyFen(1000L);
req.setParam(obj1);
AlibabaDamaiMzOrderRenderResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_damai_mz_order_render_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <total_promotion_money_fen>8000</total_promotion_money_fen>
            <goods_receive_money_fen>20000</goods_receive_money_fen>
            <goods_original_total_money_fen>28000</goods_original_total_money_fen>
            <coupon_code_promotion_money_fen>3500</coupon_code_promotion_money_fen>
            <coupon_code>ua3sk83781h13</coupon_code>
            <order_promotion_money_fen>2000</order_promotion_money_fen>
            <order_promotion_rule_id>839391012331</order_promotion_rule_id>
            <order_promotion_id>8393910123</order_promotion_id>
            <coupon_code_promotion_list>
                <render_coupon_code_promotion>
                    <promotion_name>满100-30</promotion_name>
                    <coupon_code>ua3sk83781h13</coupon_code>
                    <coupon_code_promotion_rule_id>131341445</coupon_code_promotion_rule_id>
                    <promotion_show_info>满100-30元</promotion_show_info>
                </render_coupon_code_promotion>
            </coupon_code_promotion_list>
            <order_promotion_list>
                <render_order_promotion>
                    <promotion_name>满100-20</promotion_name>
                    <order_promotion_rule_id>8387419901</order_promotion_rule_id>
                    <order_promotion_id>37647181912</order_promotion_id>
                    <promotion_show_info>满100-20元</promotion_show_info>
                </render_order_promotion>
            </order_promotion_list>
            <render_goods_list>
                <render_goods_v_o>
                    <real_name_buy_type>1</real_name_buy_type>
                    <goods_count>2</goods_count>
                    <child_goods_list>
                        <render_child_goods>
                            <event_id>7461828315230</event_id>
                            <price_type>1</price_type>
                            <price_id>9374910134</price_id>
                            <goods_count>1</goods_count>
                            <seat_id>93848215304</seat_id>
                            <real_name_buy_type>1</real_name_buy_type>
                            <price_name>180元</price_name>
                            <project_id>91828731231</project_id>
                            <project_name>乌龙山伯爵</project_name>
                            <project_img_url>https://xxx.jpg</project_img_url>
                            <event_name>2020-11-01 18:00</event_name>
                            <event_start_time>2020-11-01 18:00</event_start_time>
                            <event_end_time>2020-11-01 20:00</event_end_time>
                            <price_fen>18000</price_fen>
                            <real_price_fen>18000</real_price_fen>
                            <venue_name>北京世纪剧院</venue_name>
                            <floor_name>1楼</floor_name>
                            <stand_name>1区</stand_name>
                            <row_name>11排</row_name>
                            <seat_name>9号</seat_name>
                        </render_child_goods>
                    </child_goods_list>
                    <project_id>128371892313</project_id>
                    <project_name>乌龙山伯爵</project_name>
                    <project_img_url>https://xxx.jpg</project_img_url>
                    <event_id>7461828315230</event_id>
                    <event_name>2020-11-01 18:00</event_name>
                    <event_start_time>2020-11-01 18:00</event_start_time>
                    <event_end_time>2020-11-01 20:00</event_end_time>
                    <price_id>937491013</price_id>
                    <price_name>快速通道票</price_name>
                    <price_type>2</price_type>
                    <price_fen>18000</price_fen>
                    <real_price_fen>18000</real_price_fen>
                    <seat_id>93848215304</seat_id>
                    <venue_name>北京世纪剧院</venue_name>
                    <floor_name>1楼</floor_name>
                    <stand_name>1区</stand_name>
                    <row_name>11排</row_name>
                    <seat_name>8号</seat_name>
                </render_goods_v_o>
            </render_goods_list>
            <mz_user_id>8293090023</mz_user_id>
            <price_promotion_money_fen>9000</price_promotion_money_fen>
            <coupon_code_promotion_rule_id>2928371741</coupon_code_promotion_rule_id>
            <express_money_fen>1000</express_money_fen>
            <need_online_pay>true</need_online_pay>
            <online_payment_money_fen>18000</online_payment_money_fen>
            <customer_point_info>
                <able_deduct_point_money_fen>10000</able_deduct_point_money_fen>
                <able_deduct_point>10000</able_deduct_point>
                <customer_total_point>50000</customer_total_point>
            </customer_point_info>
            <use_point>10000</use_point>
            <use_point_money_fen>10000</use_point_money_fen>
            <customer_account_info>
                <able_deduct_account_money_fen>180000</able_deduct_account_money_fen>
                <account_money_fen>180000</account_money_fen>
            </customer_account_info>
            <use_account_money_fen>10000</use_account_money_fen>
            <card_list>
                <card>
                    <card_balance_money_fen>20000</card_balance_money_fen>
                    <card_balance_point>20000</card_balance_point>
                    <card_init_point>30000</card_init_point>
                    <card_state>1</card_state>
                    <card_no>yx717828h1213</card_no>
                    <card_type>1</card_type>
                    <card_id>12981871714</card_id>
                </card>
            </card_list>
            <use_card_id>12981871714</use_card_id>
            <use_card_money_fen>10000</use_card_money_fen>
            <able_delivery_type_list>
                <number>2</number>
                <number>3</number>
                <number>4</number>
            </able_delivery_type_list>
        </data>
        <success>true</success>
    </result>
</alibaba_damai_mz_order_render_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

返回
顶部