SUP开放接口

订单新增

POST

/v1/order/add

幂等接口

请求参数

Body 参数application/json

productId

integer

充值产品ID

必需

outOrderNo

string

必需

商户侧订单号，最长32位(保证唯一性)

businessParams

object

可选

业务参数(以下属性为充值模板中key)

account

string

可选

buyerClientIp

string

用户终端IP

可选

buyNum

integer

购买数量，默认1

必需

remark

string

备注

可选

salesChannel

string

必需

销售渠道（拼多多、淘宝、天猫、京东、苏宁、其他）（根据实际情况进行传递，如果产品有限制，会进行识别）

safePrice

integer

可选

安全价格（单位：分）（防止接入亏本，不传不校验）

finalPrice

integer

可选

最终成交价（单位：分）（如果限价产品，会拦截，不传不校验）

notifyUrl

string

必需

订单状态回调地址，为空则不回调

示例

{
  "productId": "194f445830a001",
  "outOrderNo": "2025022515013960953938350082",
  "businessParams": {
    "account": "13666666666"
  },
  "buyerClientIp": "192.168.0.1",
  "buyNum": "3",
  "remark": "",
  "salesChannel": "",
  "safePrice": "1"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/order/add' \
--header 'Content-Type: application/json' \
--data-raw '{
    "productId": "194f445830a001",
    "outOrderNo": "2025022515013960953938350082",
    "businessParams": {
        "account": "13666666666"
    },
    "buyerClientIp": "192.168.0.1",
    "buyNum": "3",
    "remark": "",
    "salesChannel": "",
    "safePrice": "1"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

msg

string

必需

data

object

必需

tradeNo

string

平台订单号

必需

salesPrice

integer

售价（单位：分）

必需

outOrderNo

string

商户侧订单号

必需

示例

成功示例异常示例

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "tradeNo": "2025021210589188810864250881",
    "salesPrice": 10,
    "outOrderNo": "2025021210589188800898584577"
  }
}

修改于 2025-04-01 12:28:42

查询产品详情

订单查询