物流信息上传2.1

全球收单-SandBox环境

https://pay-gateway1.uat.useepay.com

POST

/logistics

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/x-www-form-urlencoded

Body 参数application/x-www-form-urlencoded

transactionType

string

必需

max=18 交易类型：save

示例值:

save

sign

string

签名值

必需

示例值:

666

signType

string

必需

签名类型 MD5 / RSA (4)

示例值:

MD5

echoParam

string

可选

回声参数，Response 中将会原样返回 (256)

示例值:

qwer

courierInfo

string

必需

json string, 物流详细信息, 请参考https://useepay.gitbook.io/useepay/doc/courier

示例值:

[{"courierNumber":"16646463314543","courierCode":"4px","url":"www.4px.com"}]

reference

string

可选

useepay返回的交易订单号，非商户订单号

示例值:

1012208181358666685

merchantNo

string

商户号 (16)

必需

示例值:

500000000007381

version

string

必需

目前固定为2.1(5)

示例值:

2.1

appId

string

可选

交易域名（merchantOrderId 存在时必传）

示例值:

www.useepay.com

transactionId

string

可选

商户订单号（app 存在时必传）max = 64

示例值:

123

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://pay-gateway1.uat.useepay.com/logistics' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'transactionType=save' \
--data-urlencode 'sign=666' \
--data-urlencode 'signType=MD5' \
--data-urlencode 'echoParam=qwer' \
--data-urlencode 'courierInfo=[{"courierNumber":"16646463314543","courierCode":"4px","url":"www.4px.com"}]' \
--data-urlencode 'reference=1012208181358666685' \
--data-urlencode 'merchantNo=500000000007381' \
--data-urlencode 'version=2.1' \
--data-urlencode 'appId=www.useepay.com' \
--data-urlencode 'transactionId=123'

返回响应

🟢200成功

application/json

Body

object {0}

示例

成功示例 Responsefailed response

{
    "echoParam": "echoParam",
    "reference": "44543463463463",
    "errorCode": "0000",
    "errorMsg": "Approved or completed successfully",
    "merchantNo": "500000000007381",
    "resultCode": "succeed",
    "sign": "1aab1771d7846efb74edb801a0fd772d",
    "signType": "MD5"
}

修改于 2025-06-30 01:32:08

拒付webhook

物流信息上传(已废弃)