汇卡SUP开放接口
  1. 订单接口
汇卡SUP开放接口
  • 产品介绍
  • 加密算法
  • 接口列表
    • 运维接口
      • 健康检查
    • 分类接口
      • 查询分类列表
    • 产品接口
      • 查询产品列表
      • 查询产品详情
    • 订单接口
      • 订单新增
        POST
      • 订单查询
        POST
      • 回调通知
        POST
  1. 订单接口

订单新增

POST
/v1/order/create
最后修改时间:2025-04-08 08:15:06
幂等接口

请求参数

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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1/order/create' \
--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"
  }
}
上一页
查询产品详情
下一页
订单查询
Built with