设置订单物流信息

简述

注意

实物商品只有上传客户签收成功，该订单方可给商户结算。

• 订单如果为实物商品，商户需根据交易订单号上传该订单的物流状态

请求 URL

• /pay/merchant/setTransactionsLogistics

请求参数

• body

参数名	必选	类型	长度	说明
merchantId	是	String	32	商户编码
logisticsType	是	String	32	物流类型 overseas：海外（非沙特） domestic：国内（沙特）
orderId	是	String	32	平台交易订单号
deliveryStatus	是	String	32	物流状态 stocking：备货中 shipping：货物运输中 signed：已签收（上传签收后该订单可结算给商户）
deliveryTime	是	String	32	物流状态时间，格式：YYYY-MM-DD HH:MM:SS
deliveryInfo	否	Object	-	物流信息，对象格式（Object:deliveryInfo）

• Object:deliveryInfo

参数名	必选	类型	长度	说明
trackingNum	否	String	64	物流单号
logisticsCompany	否	String	255	物流公司
shippingAddr	否	String	255	到达地址

请求示例

{
  "merchantId": "M12345678",
  "logisticsType": "domestic",
  "orderId": "TRD202412011234331234",
  "deliveryStatus": "signed",
  "deliveryTime": "2025-01-01 12:00:30",
  "deliveryInfo": {
    "trackingNum": "2025010123455555",
    "logisticsCompany": "shun feng",
    "shippingAddr": "xxxxxxxxxx"
  }
}

响应参数

• data

参数名	类型	说明
merchantId	String	商户编码
orderId	String	平台交易订单号
merOrderId	String	商户订单号
orderStatus	String	交易结果状态 pending：交易中 success：交易成功待结算 paid：支付成功可结算 fail：失败

响应示例

{
  "code": 10000,
  "message": "success",
  "data": {
    "merchantId": "M12345678",
    "orderId": "ORD202412011234331234",
    "merOrderId": "2024121015302012345",
    "orderStatus": "paid"
  }
}