V2 API 开发文档
RSA 签名接口(/api/pay/...)。MD5 签名请查看 V1 文档。
统一下单接口
服务器后端发起支付请求,返回支付二维码、跳转 URL 等。响应为 V2 格式(code=0,含平台 RSA 签名)。
请求地址
/api/pay/create
请求方式
POST
请求参数说明
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 商户ID | pid | 是 | Int | |
| 接口类型 | method | 否 | String | web / jump / jsapi / scan,默认 web |
| 设备类型 | device | 否 | String | pc / mobile / qq / wechat / alipay / app |
| 支付方式 | type | 是 | String | 支付方式列表(scan 除外) |
| 商户订单号 | out_trade_no | 是 | String | |
| 异步通知地址 | notify_url | 是 | String | |
| 跳转通知地址 | return_url | 否 | String | |
| 商品名称 | name | 是 | String | |
| 商品金额 | money | 是 | String | 单位:元 |
| 用户IP地址 | clientip | 是 | String | 用户发起支付的 IP |
| 业务扩展参数 | param | 否 | String | |
| 被扫授权码 | auth_code | 否 | String | method=scan 时必填 |
| 用户Openid | sub_openid | 否 | String | method=jsapi 时必填 |
| 公众号AppId | sub_appid | 否 | String | 微信 jsapi 时必填 |
| 当前时间戳 | timestamp | 是 | String | 10 位 Unix 时间戳 |
| 签名字符串 | sign | 是 | String | 签名规则 |
| 签名类型 | sign_type | 是 | String | 固定 RSA |
返回参数说明
| 字段名 | 变量名 | 类型 | 描述 |
|---|---|---|---|
| 返回状态码 | code | Int | 0 为成功 |
| 错误信息 | msg | String | 失败时返回 |
| 平台订单号 | trade_no | String | |
| 发起支付类型 | pay_type | String | jump / html / qrcode / urlscheme / jsapi / app / scan |
| 发起支付参数 | pay_info | String | 根据 pay_type 不同而不同 |
| 当前时间戳 | timestamp | String | |
| 签名字符串 | sign | String | 平台 RSA 签名 |
| 签名类型 | sign_type | String | RSA |
返回示例
{
"code": 0,
"trade_no": "20160806151343349",
"pay_type": "qrcode",
"pay_info": "weixin://wxpay/bizpayurl?pr=04IPMKM",
"timestamp": "1721206072",
"sign_type": "RSA",
"sign": "..."
}
接口类型列表
| 调用值 | 描述 |
|---|---|
| web | 通用网页支付 |
| jump | 仅返回跳转 URL |
| jsapi | JSAPI 支付参数 |
| app | APP 支付参数 |
| scan | 付款码支付 |