亮色模式

API - 物流上传

POST/v3/merchants/<merchant_id>/payments/<merchant_transaction_id>/shipments

:::tip[]
用于商家上传订单物流单号和更新物流单，如对同一笔订单重复上传，会覆盖更新上一次的物流信息。对于同一笔订单可能存在多条物流信息的场景，建议每次发货后对全量物流单列表进行更新。

签名构建因子为 merchant_id，merchant_transaction_id;
访问时需要将替换为商户号，替换为商户支付交易ID；
:::

环境域名地址

生产环境：https://gpapi.lianlianpay.com/v3/merchants/<merchant_id>/payments/<merchant_transaction_id>/shipments
沙箱环境：https://celer-api.LianLianpay-inc.com/v3/merchants/<merchant_id>/payments/<merchant_transaction_id>/shipments

接口协议结构体

详情可查看请求与响应结构

请求参数

Header 参数

signature

string

签名

必需

示例值:

XJqQTCs1QTsp+xO3iWrEMhMZUF9Wt+s2XTilT48lyv3zCmJS1+twA9cYsq9Bg9hfTnOFziCaU0OD3ddYWTMRf13uyLjwwOKD6LWyBCd+17Fq4bBdFcCwiuA6ZUkXbIWKiLACf8gY0JkKpuEvXSSrvHcpS9MPakuXKKwOBRY1UXBhWr2bL3qr8r4bLUk1A3 5ZU7Oj5r2xZV3JrdeFYqBLss1jbXNT9bS4J5JFoFKw/xBzoBkYh7btm28b8i8Q5lY2Vu7vZVK+BGKfBff2PQOJ347VGyR3+ch4qrw0ABRC52jEycWWoGQbnzs6W8DwBGg64/aR7GpNz9sHIy6YW8KwZg==

timezone

string

时区

必需

示例值:

Asia/Hong_Kong

timestamp

string

必需

格式化时间戳，格式为：yyyyMMddHHmmss

示例值:

20211022160000

Content-Type

string

必需

示例值:

application/json

merchant_transaction_id

string

商户支付交易ID

必需

由商户自定义，保证在商户端唯一

<= 64 字符

merchant_id

string

商户号

必需

由连连全球收单创建分配

<= 32 字符

sub_merchant_id

string

站点号

可选

由连连全球收单创建分配

<= 32 字符

shipments

array[object (SHIPPMENT) {3}]

物流详情列表

必需

总长度不能超过1024

carrier_code

string

承运商编码

必需

详情可查看承运商

<= 64 字符

tracking_no

string

物流单号

必需

<= 128 字符

country

string

发货国家

可选

详情可查看国家编码

<= 2 字符

{
  "merchant_id": "2023042700027001",
  "merchant_transaction_id": "test177507",
  "shipments": [
    {
      "carrier_code": "yanwen",
      "tracking_no": "UJ5YP"
    }
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

return_code

string

返回码

必需

返回码

return_message

string

返回消息

必需

返回消息

trace_id

string

追踪号

必需

需要技术支持时候，请提供至LianLian Pay技术人员

{
  "return_code": "SUCCESS",
  "return_message": "Success",
  "trace_id": "4108.89.16413532101277715"
}