文档中心 > API类目 > 银泰开放平台(内部)

alibaba.mos.trade.open.haiding.order.sync (海鼎收单接口)

海鼎收单接口,包含正向和逆向能力

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_sync_request HaiDingOrderSyncRequest 必须 同步订单请求
  • order_payments
  • HaiDingOrderPaymentVO []
  • 必须
  • ""
  • 支付单
  • └ out_payment_name
  • String
  • 可选
  • 支付宝
  • 外部支付名称
  • └ payment_sub_type
  • String
  • 可选
  • 16
  • 小支付方式
  • └ out_payment_no
  • String
  • 可选
  • 202100312321
  • 外部支付流水号
  • └ pay_line_no
  • Number
  • 必须
  • 1
  • 支付行号
  • └ payment_amount
  • Number
  • 必须
  • 100
  • 支付/优惠金额
  • └ payment_type
  • String
  • 必须
  • D1
  • 大支付方式 D1
  • order_items
  • HaiDingOrderItemVO []
  • 必须
  • ""
  • 订单商品
  • └ line_no
  • Number
  • 必须
  • 1
  • 商品SKU行号
  • └ quantity
  • String
  • 必须
  • 2
  • 购买数量
  • └ counter_no
  • String
  • 必须
  • 8998
  • 专柜号
  • └ item_title
  • String
  • 必须
  • 大米
  • 商品名称
  • └ sale_price
  • Number
  • 必须
  • 90
  • 商品销售单价
  • └ out_id
  • String
  • 必须
  • 8888
  • 商品外部id
  • └ attributes
  • String
  • 可选
  • ""
  • 扩展属性
  • └ goods_code
  • String
  • 可选
  • 34234
  • 商品编码
  • └ tag_price
  • Number
  • 必须
  • 100
  • 商品吊牌单价
  • └ discount_amount
  • Number
  • 可选
  • 50
  • 折扣金额
  • order
  • HaiDingOrderVO
  • 可选
  • ""
  • 订单,订单和退款单不能同时为空
  • └ store_no
  • String
  • 可选
  • HZ01
  • 门店号
  • └ pay_time
  • Date
  • 可选
  • 2021-10-01 00:00:00
  • 支付时间
  • └ total_fee
  • Number
  • 可选
  • 180
  • 订单总金额(分) = sum(销售价 * 数量)
  • └ phone
  • String
  • 可选
  • 138979923123
  • 买家手机号
  • └ subject
  • String
  • 可选
  • 购物订单
  • 订单标题
  • └ open_id
  • Number
  • 可选
  • 21312
  • 会员openId
  • └ out_trade_no
  • String
  • 可选
  • 20211001231231
  • 外部订单号
  • └ attributes
  • String
  • 可选
  • ""
  • 扩展属性
  • └ gmt_create
  • Date
  • 可选
  • 2021-10-01 00:00:00
  • 下单时间
  • └ is_intime_counter
  • Boolean
  • 可选
  • true
  • 是否在银专柜
  • order_share_promotions
  • HaiDingOrderSharePaymentVO []
  • 必须
  • ""
  • 支付分摊
  • └ out_payment_name
  • String
  • 可选
  • 支付宝
  • 外部支付名称
  • └ item_line_no
  • Number
  • 必须
  • 1
  • 商品行号
  • └ payment_sub_type
  • String
  • 可选
  • 14
  • 小支付方式
  • └ out_payment_no
  • String
  • 可选
  • 213213421
  • 外部支付流水号
  • └ split_amount
  • Number
  • 必须
  • 90
  • 分摊金额(分)
  • └ pay_line_no
  • Number
  • 必须
  • 1
  • 支付行号
  • └ payment_type
  • String
  • 必须
  • D1
  • 大支付方式
  • refund_order
  • HaiDingRefundOrderVO
  • 可选
  • ""
  • 退款订单,订单和退款单不能同时为空
  • └ gmt_create
  • Date
  • 可选
  • 2021-10-01 00:00:00
  • 创建时间
  • └ out_trade_no
  • String
  • 可选
  • 20211001231231
  • 外部原单订单号
  • └ out_refund_no
  • String
  • 可选
  • 20211001231232
  • 外部逆向订单号
  • └ store_no
  • String
  • 可选
  • HZ01
  • 门店号
  • └ phone
  • String
  • 可选
  • 138979923123
  • 手机号
  • └ open_id
  • Number
  • 可选
  • 21312
  • 买家openid
  • └ refund_amount
  • Number
  • 可选
  • 180
  • 退款金额=sum(销售价*退款数量)
  • └ refund_time
  • Date
  • 可选
  • 2021-10-01 00:00:00
  • 退款时间
  • └ refund_reason
  • String
  • 可选
  • 商品退款
  • 退款原因
  • └ is_intime_counter
  • Boolean
  • 可选
  • true
  • 是否在银专柜
  • └ attributes
  • String
  • 可选
  • ""
  • 扩展字段

响应参数

名称 类型 示例值 描述
oc_trade_no String 2021011000031231 oc正向订单号
out_trade_no String 2021011000031231 外部订单号
oc_refund_no String 2021011000031231 oc逆向订单号

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMosTradeOpenHaidingOrderSyncRequest req = new AlibabaMosTradeOpenHaidingOrderSyncRequest();
AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderSyncRequest obj1 = new AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderSyncRequest();
List<AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderPaymentVO> list3 = new ArrayList<AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderPaymentVO>();
AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderPaymentVO obj4 = new AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderPaymentVO();
list3.add(obj4);
obj4.setOutPaymentName("支付宝");
obj4.setPaymentSubType("16");
obj4.setOutPaymentNo("202100312321");
obj4.setPayLineNo(1L);
obj4.setPaymentAmount(100L);
obj4.setPaymentType("D1");
obj1.setOrderPayments(list3);
List<AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderItemVO> list6 = new ArrayList<AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderItemVO>();
AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderItemVO obj7 = new AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderItemVO();
list6.add(obj7);
obj7.setLineNo(1L);
obj7.setQuantity("2");
obj7.setCounterNo("8998");
obj7.setItemTitle("大米");
obj7.setSalePrice(90L);
obj7.setOutId("8888");
obj7.setAttributes("\"\"");
obj7.setGoodsCode("34234");
obj7.setTagPrice(100L);
obj7.setDiscountAmount(50L);
obj1.setOrderItems(list6);
AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderVO obj8 = new AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderVO();
obj8.setStoreNo("HZ01");
obj8.setPayTime(StringUtils.parseDateTime("2021-10-01 00:00:00"));
obj8.setTotalFee(180L);
obj8.setPhone("138979923123");
obj8.setSubject("购物订单");
obj8.setOpenId(21312L);
obj8.setOutTradeNo("20211001231231");
obj8.setAttributes("\"\"");
obj8.setGmtCreate(StringUtils.parseDateTime("2021-10-01 00:00:00"));
obj8.setIsIntimeCounter(true);
obj1.setOrder(obj8);
List<AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderSharePaymentVO> list10 = new ArrayList<AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderSharePaymentVO>();
AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderSharePaymentVO obj11 = new AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingOrderSharePaymentVO();
list10.add(obj11);
obj11.setOutPaymentName("支付宝");
obj11.setItemLineNo(1L);
obj11.setPaymentSubType("14");
obj11.setOutPaymentNo("213213421");
obj11.setSplitAmount(90L);
obj11.setPayLineNo(1L);
obj11.setPaymentType("D1");
obj1.setOrderSharePromotions(list10);
AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingRefundOrderVO obj12 = new AlibabaMosTradeOpenHaidingOrderSyncRequest.HaiDingRefundOrderVO();
obj12.setGmtCreate(StringUtils.parseDateTime("2021-10-01 00:00:00"));
obj12.setOutTradeNo("20211001231231");
obj12.setOutRefundNo("20211001231232");
obj12.setStoreNo("HZ01");
obj12.setPhone("138979923123");
obj12.setOpenId(21312L);
obj12.setRefundAmount(180L);
obj12.setRefundTime(StringUtils.parseDateTime("2021-10-01 00:00:00"));
obj12.setRefundReason("商品退款");
obj12.setIsIntimeCounter(true);
obj12.setAttributes("\"\"");
obj1.setRefundOrder(obj12);
req.setOrderSyncRequest(obj1);
AlibabaMosTradeOpenHaidingOrderSyncResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_mos_trade_open_haiding_order_sync_response>
    <oc_trade_no>2021011000031231</oc_trade_no>
    <out_trade_no>2021011000031231</out_trade_no>
    <oc_refund_no>2021011000031231</oc_refund_no>
</alibaba_mos_trade_open_haiding_order_sync_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

返回
顶部