同步业务单据物流信息

能力概览

注意

实物商品订单需上报用户已签收状态后，平台才会进入结算处理。

• 业务单据如果为实物商品，接入方需根据交易业务单据号上传该业务单据的物流处理状态

调用地址

• /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": "MER20460873",
  "logisticsType": "domestic",
  "orderId": "TRD20260509104532001876",
  "deliveryStatus": "signed",
  "deliveryTime": "2026-05-10 15:20:30",
  "deliveryInfo": {
    "trackingNum": "KSA202605100045",
    "logisticsCompany": "Riyadh Express",
    "shippingAddr": "Olaya Street Building 18, Riyadh"
  }
}

响应参数

• data

字段	数据类型	业务含义
merchantId	String	当前收款订单所属的接入方标识
orderId	String	平台生成的收款交易订单号
merOrderId	String	接入方提交的收款订单号
orderStatus	String	收款订单当前处理状态 pending：交易中 success：交易成功待结算 paid：支付成功可结算 fail：失败

响应示例

{
  "code": 10000,
  "message": "success",
  "data": {
    "merchantId": "MER20460873",
    "orderId": "TRD20260509104532001876",
    "merOrderId": "PAYIN202605090001",
    "orderStatus": "paid"
  }
}