---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/checkout/api/LogisticsUpload/index.md
description: >-
  LogisticsUpload接口用于上传订单物流信息。适用于电商平台在用户完成支付后，商家需要更新订单物流状态的场景。支持的主要功能包括添加或更新物流详情，关键参数有订单ID、物流公司及物流单号等。
---
# 上传物流信息

```apidef
endpoint: POST /v4/logistics/upload
name: 上传物流信息
tags: Checkout, Upload
```

LogisticsUpload接口用于上传订单物流信息。适用于电商平台在用户完成支付后，商家需要更新订单物流状态的场景。支持的主要功能包括添加或更新物流详情，关键参数有订单ID、物流公司及物流单号等。

## 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| accId | string | M | 店铺唯一标识 |
| clientId | string | M | PingPong 商户号 |
| signType | string | M | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | M | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| version | string | M | 版本号，当前固定为1.0，后续随接口变动可能有调整 |
| bizContent | string | M | 请求参数的集合，最大长度不限，除公共请求参数外所有请求参数都必须放在这个参数中传递，格式：JSON字符串。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ merchantTransactionId | string | M | 商户网站订单号 |
| └─ trackingNumber | string | M | 物流单号 |
| └─ logisticsCompany | string | M | 物流公司 |
| └─ logisticsCompanyUrl | string | M | 物流查询网址 Url |

### 请求示例

```json
{
  "accId": "2023042011040310224447",
  "bizContent": "{\"trackingNumber\":\"SF2314234131314\",\"merchantTransactionId\":\"PMT-2S7RR3K4LQ1715047351210\",\"logisticsCompany\":\"顺丰\",\"logisticsCompanyUrl\":\"https://test-acquirerpay.pingpongx.com/qa/notify\"}",
  "clientId": "2023042011040310224",
  "sign": "FD92418286FF6EDD5F7D28063567FABFEBBC48297E1D410AD8FED19193B64D40",
  "signType": "SHA256",
  "version": "1.0"
}
```

## 响应参数

| 参数名 | 类型 | 说明 |
|--------|------|------|
| accId | string | 店铺唯一标识 |
| clientId | string | PingPong 商户号 |
| signType | string | 支持 MD5 、 SHA256 ，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/一栏 |
| sign | string | 签名，具体⻅本文签名规约: /notes/zh/onlinePayment/developer/sign/，所有参数均参与签名 |
| bizContent | string | 业务响应参数。该字段内容为 JSON 字符串，反序列化后的结构见 contentSchema。 |
| └─ merchantTransactionId | string | 商户网站订单号 |
| └─ trackingNumber | string | 物流单号 |
| └─ logisticsCompany | string | 物流公司 |
| └─ logisticsCompanyUrl | string | 物流查询地址 |
| └─ result | string | YES/NO |
| └─ reason | string | 上传失败原因 |

### 响应示例

```json
{
  "accId": "2023042011040310224447",
  "bizContent": "{\"result\":\"YES\",\"logisticsCompanyUrl\":\"https://test-acquirerpay.pingpongx.com/qa/notify\",\"logisticsCompany\":\"顺丰\",\"merchantTransactionId\":\"PMT-2S7RR3K4LQ1715047351210\",\"trackingNumber\":\"SF2314234131314\"}",
  "clientId": "2023042011040310224",
  "sign": "97EDF744606E4E393A6C198D7A8AC65648AF58C0E3E6D8A7E918843C747DA4F8",
  "signType": "SHA256"
}
```