PAYMENT
02
API 下单
此接口用于服务器后端发起支付请求,返回 JSON 数据,包含支付二维码链接、跳转 URL 或 JSAPI 参数等。V2
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
| 商户 ID | pid | 是 | Int | 1001 | |
| 接口类型 | method | 是 | String | web | 见下方接口类型列表 |
| 设备类型 | device | 否 | String | pc | 仅 web 支付需要 |
| 支付方式 | type | 是 | String | alipay | alipay/wxpay/qqpay 等 |
| 商户订单号 | out_trade_no | 是 | String | 20260908001 | |
| 异步通知地址 | notify_url | 是 | String | https://xxx/notify.php | |
| 跳转通知地址 | return_url | 否 | String | https://xxx/return.php | |
| 商品名称 | name | 是 | String | VIP会员 | |
| 商品金额 | money | 是 | String | 1.00 | 单位:元 |
| 用户 IP | clientip | 是 | String | 192.168.1.1 | 用户发起支付的 IP |
| 业务扩展参数 | param | 否 | String | | 支付后原样返回 |
| 被扫授权码 | auth_code | 否 | String | | 仅付款码支付需要 |
| 用户 Openid | sub_openid | 否 | String | | 仅 JSAPI 支付需要 |
| 应用 AppId | sub_appid | 否 | String | | 仅微信 JSAPI 需要 |
| 是否小程序 | is_applet | 否 | Int | 1 | 仅 JSAPI,1=小程序 |
| 手续费承担方 | fee_mode | 否 | Int | 0 | 0:商家承担,1:买家承担 |
| 时间戳 | timestamp | 是 | String | 1721206072 | 10 位整数 |
| 签名 | sign | 是 | String | | |
| 签名类型 | sign_type | 是 | String | RSA | |
接口类型(method)列表
| 调用值 | 描述 |
web | 通用网页支付(根据 device 自动返回跳转 URL / 二维码 / 小程序 URL) |
jump | 跳转支付,仅返回跳转 URL |
jsapi | JSAPI 支付(小程序内支付,需传 sub_openid 和 sub_appid) |
app | APP 支付(iOS/安卓 APP 内支付) |
scan | 付款码支付(需传 auth_code) |
applet | 小程序支付(微信小程序内使用) |
设备类型(device)列表
| 调用值 | 描述 |
pc | 电脑浏览器(默认) |
mobile | 手机浏览器 |
wechat | 微信内浏览器 |
alipay | 支付宝客户端 |
qq | 手机 QQ 内浏览器 |
douyin | 抖音 APP |
返回参数
| 字段名 | 变量名 | 类型 | 示例值 | 描述 |
| 返回状态码 | code | Int | 0 | 0 为成功,其它为失败 |
| 错误信息 | msg | String | | 失败时返回原因 |
| 平台订单号 | trade_no | String | 20260908001 | 平台内部订单号 |
| 发起支付类型 | pay_type | String | qrcode | 见下方说明 |
| 发起支付参数 | pay_info | String | weixin://... | 根据 pay_type 返回不同内容 |
| 时间戳 | timestamp | String | 1721206072 | |
| 签名 | sign | String | | 需验签 |
| 签名类型 | sign_type | String | RSA | |
发起支付类型(pay_type)说明
| pay_type | 描述 |
jump | 返回支付跳转 URL,直接跳转即可 |
qrcode | 返回二维码链接,前端生成二维码展示 |
html | 返回 HTML 代码,用于支付跳转 |
urlscheme | 返回微信/支付宝小程序跳转 URL Scheme |
jsapi | 返回 JSAPI 支付参数(JSON 字符串) |
app | 返回 APP 支付参数 |
scan | 付款码支付成功,返回订单信息 |
wxplugin | 返回微信小程序插件参数 |
wxapp | 返回拉起微信小程序的参数和路径 |
返回示例
{
"code": 0,
"trade_no": "20260908001",
"pay_type": "qrcode",
"pay_info": "weixin://wxpay/bizpayurl?pr=04IPMKM",
"timestamp": "1721206072",
"sign": "...",
"sign_type": "RSA"
}
提示:代码中需根据返回的 pay_type 展示对应支付页面。如果不确定如何处理,可传 method=jump,这样只会返回 jump 类型,直接跳转支付即可。