创建订单接口
- 通过接口的方式创建订单,避免用户利用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 作者:李伟