创建订单接口

  • 通过接口的方式创建订单,避免用户利用js下单创造漏洞
  • 需要在平台/开放平台设置/令牌管理中,对相应的令牌增加下单权限
  • 节点科技/标点云已经默认添加下单权限

接口地址

POST http://{站点host}/openapi/payment/create-order

请求参数

示例

{
    "version": "5.0",
    "type": 10001,
    "title": "qianfanVIP月卡(赠送4个3元红包",
    "gold": "0.0",
    "cash": "5.0",
    "out_trade_no": "938909627355375602",
    "pay_type_allow": 14,
    "expired_at": "1690899169",
    "notify_url": "",
    "ext": "",
    "uid": 123
}

参数说明

字段名 类型 是否必填 说明
uid int 必填 app的用户uid
version string 必填 创建订单的版本,目前固定为”5.0”
type int 必填 订单类型, 在后台插件账户平台里面创建教程
title string - 订单标题\说明
out_trade_no string - 站点自己的商户订单号
需要唯一,可为空,千帆会默认分配一个22位的订单号(老版是20位)
站点可以选择一个其他长度的订单号,来避开千帆的规则,这样可以最大可能的避免重复订单号的出现
重复订单号会导致下单失败
expired_at int - 允许最后的支付时间戳,默认15分钟
cash float - 订单的现金价格(元)
gold float - 订单的金币价格
pay_type_allow int - 订单现金部分,允许的支付方式
2:余额,4:微信,8:支付宝
如想允许多钟方式,求和即可
notify_url string - 支付完成后异步回调的地址
ext string - 订单的其他参数,异步回调时会带回去
profit_sharing int - 是否进行分账,0 不分账 1 分账,仅采用微信支付时有效
具体分账逻辑需要自行开发,该参数仅开启该微信订单支持分账开关

返回

示例

{
    "code": 0,
    "text": "",
    "data": {
        "order_id": 2019383
    },
    "time": 1690958845
}

data字段说明

字段名 类型 说明
order_id int 订单ID,如果订单为0,表示异常
文档更新时间: 2023-10-18 14:42   作者:李伟