Onerway
POST

上传物流信息

该接口用于为交易关联物流配送信息,可用于结算确认、订单追踪与争议处理。对于 stc pay 结算场景,仅在实体商品交易已成功完成且包裹已签收后上传物流信息。

请求

merchantNo
Onerway 分配的商户号;获取方式参见接入准备。
示例:
transactionId
本次上传物流信息对应的 Onerway 交易号,JSON 以 String 传输。
示例:
约束
规则
仅可为已成功完成的交易上传物流信息。
规则
再次提交相同的 transactionId 时,系统会用本次提交的物流信息自动覆盖已有信息。
不支持
用于 stc pay 结算时,本物流结算前置条件不支持虚拟商品交易或分期交易。
carrierNo
物流公司编码,用于标识承运商并追踪包裹物流信息。
示例:
约束
取值
请从 Onerway 物流公司编码列表 选择取值;该下载列表覆盖全球 1000+ 家物流公司。
trackingNo
物流追踪单号,由物流公司提供,用于查询包裹配送进度与签收状态。
示例:
约束
规则
用于 stc pay 结算时,仅在包裹已送达客户并签收后上传物流信息。
sign
请求签名字符串;生成方式详见请求签名。

请求示例

curl -X POST 'https://sandbox-acq.onerway.com/v1/txn/uploadLogisticsInfo' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "carrierNo": "SF",
  "merchantNo": "replace_with_merchant_no",
  "sign": "{{SIGN}}",
  "trackingNo": "SF1234567890",
  "transactionId": "example_transaction_id"
}'

响应

respCode
响应码;20000 表示上传请求处理成功,其余为错误码。完整码表见响应码。
respMsg
响应码对应的可读消息。
data
物流上传成功对应的 Onerway 交易订单号。
示例:
约束
规则
data 是交易订单号字符串本身,不是嵌套对象。

响应示例

示例代码暂不可用。

20050018

交易不存在

触发条件: 交易不存在,或不属于 merchantNo 指定的商户。

示例

{
  "respCode": "50018",
  "respMsg": "Non-existent order!",
  "data": null
}
20050204

交易状态不符合要求

触发条件: 交易尚未成功完成,包括处理中或已失败的交易。

示例

{
  "respCode": "50204",
  "respMsg": "Wrong order status!",
  "data": null
}
20050000

系统错误

触发条件: 保存物流信息时发生系统错误。

示例

{
  "respCode": "50000",
  "respMsg": "System error",
  "data": null
}