Skip to main content
POST
/
api
/
pay
/
unifiedOrder
统一下单
curl --request POST \
  --url https://sandbox-pay.epay123.net/api/pay/unifiedOrder \
  --header 'Content-Type: application/json' \
  --data '
{
  "version": "1.0.1",
  "signType": "MD5",
  "sign": "xxxxxx",
  "reqTime": "1622016572190",
  "mchNo": "M1234567890",
  "appId": "88808634c46ff1a7807888888",
  "mchOrderNo": "mho1624005107281",
  "wayCode": "QR_CASHIER",
  "amount": 100,
  "currency": "USD",
  "subject": "商品标题",
  "body": "商品描述",
  "clientIp": "192.166.1.132",
  "notifyUrl": "https://xxx/notify",
  "returnUrl": "https://xxx/returnUrl",
  "expiredTime": 3600,
  "channelExtra": "{\"authCode\":\"280812820366966512\"}",
  "extParam": "{}",
  "divisionMode": 1,
  "channelUserId": "<string>"
}
'
{
  "code": 200,
  "msg": "成功",
  "data": {
    "payOrderId": "P202106181642329900002",
    "mchOrderNo": "mho1624005752661",
    "orderState": 3,
    "payDataType": "<string>",
    "payData": "<string>",
    "errCode": "ACQ.PAYMENT_AUTH_CODE_INVALID",
    "errMsg": "Business Failed"
  },
  "sign": "<string>"
}

Body

application/json

统一下单请求参数

​
version
string
required

版本号

Example:

"1.0.1"

​
signType
string
required

签名类型，目前只支持MD5方式

Example:

"MD5"

​
sign
string
required

签名值，详见签名算法

Example:

"xxxxxx"

​
reqTime
string
required

时间戳,13位时间戳

Example:

"1622016572190"

​
mchNo
string
required

商户号

Example:

"M1234567890"

​
appId
string
required

商户应用ID

Example:

"88808634c46ff1a7807888888"

​
mchOrderNo
string
required

商户订单号

Example:

"mho1624005107281"

​
wayCode
string
required

支付方式 如： QR_CASHIER、CB_COIN_ADDR等

Example:

"QR_CASHIER"

​
amount
integer<int64>
required

支付金额， 单位：分

Required range: x >= 1
Example:

100

​
currency
string
required

货币代码

Example:

"USD"

​
subject
string
required

商品标题

Example:

"商品标题"

​
body
string
required

商品描述信息

Example:

"商品描述"

​
clientIp
string

客户端IP地址

Example:

"192.166.1.132"

​
notifyUrl
string

异步通知地址

Example:

"https://xxx/notify"

​
returnUrl
string

跳转通知地址

Example:

"https://xxx/returnUrl"

​
expiredTime
integer<int32>

订单失效时间, 单位：秒

Example:

3600

​
channelExtra
string

特定渠道发起额外参数

Example:

"{\"authCode\":\"280812820366966512\"}"

​
extParam
string

商户扩展参数

Example:

"{}"

​
divisionMode
integer<int32>

分账模式： 0-该笔订单不允许分账, 1-支付成功按配置自动完成分账, 2-商户手动分账(解冻商户金额)

Example:

1

​
channelUserId
string

Response

200 - */*

成功返回结果

​
code
integer<int32>

业务响应码

Example:

200

​
msg
string

业务响应信息

Example:

"成功"

​
data
data · object

数据对象

​
sign
string

签名值