支付相关接口
页面跳转支付
统一下单接口
订单查询
订单退款
订单退款查询
支付结果通知
-
+
首页
统一下单接口
>i **此接口可用于服务器后端发起支付请求,会返回支付二维码链接、支付跳转url等。** > ### 请求地址: https://cc.txyi.cc/api/pay/create ### 请求方式: POST ### 请求参数说明: <table class="layui-table"><thead><tr><th align="left">字段名</th><th align="left">变量名</th><th align="left">必填</th><th align="left">类型</th><th align="left">示例值</th><th align="left">描述</th></tr></thead><tbody><tr><td align="left">商户ID</td><td align="left">pid</td><td align="left">是</td><td align="left">Int</td><td align="left">1001</td><td align="left"> </td></tr><tr><td align="left">接口类型</td><td align="left">method</td><td align="left">是</td><td align="left">String</td><td align="left">web</td><td align="left"><a href="#接口类型列表">接口类型列表</a></td></tr><tr><td align="left">设备类型</td><td align="left">device</td><td align="left">否</td><td align="left">String</td><td align="left">pc</td><td align="left">仅通用网页支付需要传 <a href="#设备类型列表">设备类型列表</a></td></tr><tr><td align="left">支付方式</td><td align="left">type</td><td align="left">是</td><td align="left">String</td><td align="left">alipay</td><td align="left"><a href="https://doc.jjzfw.com/doc/4/">支付方式列表</a></td></tr><tr><td align="left">商户订单号</td><td align="left">out_trade_no</td><td align="left">是</td><td align="left">String</td><td align="left">20160806151343349</td><td align="left"> </td></tr><tr><td align="left">异步通知地址</td><td align="left">notify_url</td><td align="left">是</td><td align="left">String</td><td align="left">http://www.pay.com/notify_url.php</td><td align="left">服务器异步通知地址</td></tr><tr><td align="left">跳转通知地址</td><td align="left">return_url</td><td align="left">是</td><td align="left">String</td><td align="left">http://www.pay.com/return_url.php</td><td align="left">页面跳转通知地址</td></tr><tr><td align="left">商品名称</td><td align="left">name</td><td align="left">是</td><td align="left">String</td><td align="left">VIP会员</td><td align="left">如超过127个字节会自动截取</td></tr><tr><td align="left">商品金额</td><td align="left">money</td><td align="left">是</td><td align="left">String</td><td align="left">1.00</td><td align="left">单位:元,最大2位小数</td></tr><tr><td align="left">用户IP地址</td><td align="left">clientip</td><td align="left">是</td><td align="left">String</td><td align="left">192.168.1.100</td><td align="left">用户发起支付的IP地址</td></tr><tr><td align="left">业务扩展参数</td><td align="left">param</td><td align="left">否</td><td align="left">String</td><td align="left">没有请留空</td><td align="left">支付后原样返回</td></tr><tr><td align="left">被扫支付授权码</td><td align="left">auth_code</td><td align="left">否</td><td align="left">String</td><td align="left"> </td><td align="left">仅被扫支付需要传</td></tr><tr><td align="left">用户Openid</td><td align="left">sub_openid</td><td align="left">否</td><td align="left">String</td><td align="left"> </td><td align="left">仅JSAPI支付需要传</td></tr><tr><td align="left">公众号AppId</td><td align="left">sub_appid</td><td align="left">否</td><td align="left">String</td><td align="left"> </td><td align="left">仅JSAPI支付需要传</td></tr><tr><td align="left">自定义通道ID</td><td align="left">channel_id</td><td align="left">否</td><td align="left">Int</td><td align="left"> </td><td align="left">对应进件商户列表的ID,未进件请勿传</td></tr><tr><td align="left">当前时间戳</td><td align="left">timestamp</td><td align="left">是</td><td align="left">String</td><td align="left">1721206072</td><td align="left">10位整数,单位秒</td></tr><tr><td align="left">签名字符串</td><td align="left">sign</td><td align="left">是</td><td align="left">String</td><td align="left"> </td><td align="left">参考签名规则</td></tr><tr><td align="left">签名类型</td><td align="left">sign_type</td><td align="left">是</td><td align="left">String</td><td align="left">RSA</td><td align="left">默认为RSA</td></tr></tbody></table> ### 返回参数说明: <table class="layui-table"><thead><tr><th align="left">字段名</th><th align="left">变量名</th><th align="left">类型</th><th align="left">示例值</th><th align="left">描述</th></tr></thead><tbody><tr><td align="left">返回状态码</td><td align="left">code</td><td align="left">Int</td><td align="left">0</td><td align="left">0为成功,其它值为失败</td></tr><tr><td align="left">错误信息</td><td align="left">msg</td><td align="left">String</td><td align="left"> </td><td align="left">失败时返回原因</td></tr><tr><td align="left">平台订单号</td><td align="left">trade_no</td><td align="left">String</td><td align="left">20160806151343349</td><td align="left">平台内部的订单号</td></tr><tr><td align="left">发起支付类型</td><td align="left">pay_type</td><td align="left">String</td><td align="left">jump</td><td align="left">参考 <a href="#发起支付类型说明">发起支付类型说明</a></td></tr><tr><td align="left">发起支付参数</td><td align="left">pay_info</td><td align="left">String</td><td align="left">weixin://wxpay/bizpayurl?pr=04IPMKM</td><td align="left">根据不同的发起支付类型,返回内容也不一样</td></tr><tr><td align="left">当前时间戳</td><td align="left">timestamp</td><td align="left">String</td><td align="left">1721206072</td><td align="left">10位整数,单位秒</td></tr><tr><td align="left">签名字符串</td><td align="left">sign</td><td align="left">String</td><td align="left"> </td><td align="left">参考签名规则</td></tr><tr><td align="left">签名类型</td><td align="left">sign_type</td><td align="left">String</td><td align="left">RSA</td><td align="left">默认为RSA</td></tr></tbody></table> #### 返回示例: <table border="0" cellpadding="0" cellspacing="0" class="syntaxhighlighter text"><tbody><tr><td class="gutter"><div class="line number1 index0 alt2" style="height: 23px;">1</div><div class="line number2 index1 alt1" style="height: 23px;">2</div><div class="line number3 index2 alt2" style="height: 23px;">3</div><div class="line number4 index3 alt1" style="height: 23px;">4</div><div class="line number5 index4 alt2" style="height: 23px;">5</div><div class="line number6 index5 alt1" style="height: 23px;">6</div></td><td class="code"><div class="container"><div class="line number1 index0 alt2" style="height: 23px;"><code class="text plain">{</code></div><div class="line number2 index1 alt1" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"code": 0,</code></div><div class="line number3 index2 alt2" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"trade_no": "20160806151343349",</code></div><div class="line number4 index3 alt1" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"pay_type": "qrcode",</code></div><div class="line number5 index4 alt2" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"pay_info": "weixin://wxpay/bizpayurl?pr=04IPMKM"</code></div><div class="line number6 index5 alt1" style="height: 23px;"><code class="text plain">}</code></div></div></td></tr></tbody></table> <table border="0" cellpadding="0" cellspacing="0" class="syntaxhighlighter text"><tbody><tr><td class="gutter"><div class="line number1 index0 alt2" style="height: 23px;">1</div><div class="line number2 index1 alt1" style="height: 23px;">2</div><div class="line number3 index2 alt2" style="height: 23px;">3</div><div class="line number4 index3 alt1" style="height: 23px;">4</div><div class="line number5 index4 alt2" style="height: 46px;">5</div><div class="line number6 index5 alt1" style="height: 23px;">6</div></td><td class="code"><div class="container"><div class="line number1 index0 alt2" style="height: 23px;"><code class="text plain">{</code></div><div class="line number2 index1 alt1" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"code": 0,</code></div><div class="line number3 index2 alt2" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"trade_no": "20160806151343351",</code></div><div class="line number4 index3 alt1" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"pay_type": "jsapi",</code></div><div class="line number5 index4 alt2" style="height: 46px;"><code class="text spaces"> </code><code class="text plain">"pay_info": "{\"appId\":\"wx2421b1c4370ec43b\",\"timeStamp\":\"1395712654\",\"nonceStr\":\"e61463f8efa94090b1f366cccfbbb444\",\"package\":\"prepay_id=up_wx21201855730335ac86f8c43d1889123400\",\"signType\":\"RSA\",\"paySign\":\"oR9d8PuhnIc+YZ8cBHFCwfgpaK9gd7vaRvkYD7rthRAZ\"}"</code></div><div class="line number6 index5 alt1" style="height: 23px;"><code class="text plain">}</code></div></div></td></tr></tbody></table> <table border="0" cellpadding="0" cellspacing="0" class="syntaxhighlighter text"><tbody><tr><td class="gutter"><div class="line number1 index0 alt2" style="height: 23px;">1</div><div class="line number2 index1 alt1" style="height: 23px;">2</div><div class="line number3 index2 alt2" style="height: 23px;">3</div><div class="line number4 index3 alt1" style="height: 23px;">4</div><div class="line number5 index4 alt2" style="height: 23px;">5</div><div class="line number6 index5 alt1" style="height: 23px;">6</div></td><td class="code"><div class="container"><div class="line number1 index0 alt2" style="height: 23px;"><code class="text plain">{</code></div><div class="line number2 index1 alt1" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"code": 0,</code></div><div class="line number3 index2 alt2" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"trade_no": "2024072320222180092",</code></div><div class="line number4 index3 alt1" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"pay_type": "scan",</code></div><div class="line number5 index4 alt2" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"pay_info": "{\"type\":\"wxpay\",\"trade_no\":\"2024072320222180092\",\"api_trade_no\":\"4200002345202407238253501450\",\"buyer\":\"o9uAcc6VlZxhcujpKIqQuWWoDQc\",\"money\":\"1.00\"}"</code></div><div class="line number6 index5 alt1" style="height: 23px;"><code class="text plain">}</code></div></div></td></tr></tbody></table> <table border="0" cellpadding="0" cellspacing="0" class="syntaxhighlighter text"><tbody><tr><td class="gutter"><div class="line number1 index0 alt2" style="height: 23px;">1</div><div class="line number2 index1 alt1" style="height: 23px;">2</div><div class="line number3 index2 alt2" style="height: 23px;">3</div><div class="line number4 index3 alt1" style="height: 23px;">4</div><div class="line number5 index4 alt2" style="height: 23px;">5</div><div class="line number6 index5 alt1" style="height: 23px;">6</div></td><td class="code"><div class="container"><div class="line number1 index0 alt2" style="height: 23px;"><code class="text plain">{</code></div><div class="line number2 index1 alt1" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"code": 0,</code></div><div class="line number3 index2 alt2" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"trade_no": "2024072320222180018",</code></div><div class="line number4 index3 alt1" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"pay_type": "wxplugin",</code></div><div class="line number5 index4 alt2" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"pay_info": "{\"appId\":\"wxc237fd59fbb634ae\",\"supplierId\":\"123456\",\"shopId\":\"123456\",\"orderId\":\"2024072320222180092\"}"</code></div><div class="line number6 index5 alt1" style="height: 23px;"><code class="text plain">}</code></div></div></td></tr></tbody></table> <table border="0" cellpadding="0" cellspacing="0" class="syntaxhighlighter text"><tbody><tr><td class="gutter"><div class="line number1 index0 alt2" style="height: 23px;">1</div><div class="line number2 index1 alt1" style="height: 23px;">2</div><div class="line number3 index2 alt2" style="height: 23px;">3</div><div class="line number4 index3 alt1" style="height: 23px;">4</div><div class="line number5 index4 alt2" style="height: 23px;">5</div><div class="line number6 index5 alt1" style="height: 23px;">6</div></td><td class="code"><div class="container"><div class="line number1 index0 alt2" style="height: 23px;"><code class="text plain">{</code></div><div class="line number2 index1 alt1" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"code": 0,</code></div><div class="line number3 index2 alt2" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"trade_no": "2024072320222180018",</code></div><div class="line number4 index3 alt1" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"pay_type": "wxapp",</code></div><div class="line number5 index4 alt2" style="height: 23px;"><code class="text spaces"> </code><code class="text plain">"pay_info": "{\"appId\":\"wxbb48bac536053072\",\"miniProgramId\":\"gh_bf9cd8cf50b5\",\"path\":\"pages/fromAppPay/index?orderid=123456\",\"extraData\":\"\"}"</code></div><div class="line number6 index5 alt1" style="height: 23px;"><code class="text plain">}</code></div></div></td></tr></tbody></table> ### 接口类型列表 <table class="layui-table"><thead><tr><th align="left">调用值</th><th align="left">描述</th></tr></thead><tbody><tr><td align="left">web</td><td align="left">通用网页支付(会根据device判断,自动<br>返回跳转url/二维码/小程序跳转url等)</td></tr><tr><td align="left">jump</td><td align="left">跳转支付(仅会返回跳转url)</td></tr><tr><td align="left">jsapi</td><td align="left">JSAPI支付(小程序内支付使用,仅返回JSAPI参数,<br>需传入sub_openid和sub_appid参数)</td></tr><tr><td align="left">app</td><td align="left">APP支付(iOS/安卓APP内支付使用,<br>仅返回APP支付参数,或APP拉起微信小程序参数)</td></tr><tr><td align="left">scan</td><td align="left">付款码支付(需传入auth_code参数,<br>支付成功后返回订单信息)</td></tr><tr><td align="left">applet</td><td align="left">小程序支付(微信小程序内使用,<br>返回微信小程序插件参数或跳转小程序参数)</td></tr></tbody></table> ### 设备类型列表 <table class="layui-table"><thead><tr><th align="left">调用值</th><th align="left">描述</th></tr></thead><tbody><tr><td align="left">pc</td><td align="left">电脑浏览器(默认)</td></tr><tr><td align="left">mobile</td><td align="left">手机浏览器</td></tr><tr><td align="left">qq</td><td align="left">手机QQ内浏览器</td></tr><tr><td align="left">wechat</td><td align="left">微信内浏览器</td></tr><tr><td align="left">alipay</td><td align="left">支付宝客户端</td></tr></tbody></table> ### 发起支付类型说明 <table class="layui-table"><thead><tr><th align="left">发起支付类型</th><th align="left">描述</th></tr></thead><tbody><tr><td align="left">jump</td><td align="left">返回支付跳转url</td></tr><tr><td align="left">html</td><td align="left">返回html代码,用于支付跳转</td></tr><tr><td align="left">qrcode</td><td align="left">返回支付二维码</td></tr><tr><td align="left">urlscheme</td><td align="left">返回微信/支付宝小程序跳转url scheme</td></tr><tr><td align="left">jsapi</td><td align="left">返回用于发起JSAPI支付的参数</td></tr><tr><td align="left">app</td><td align="left">返回用于发起APP支付的参数</td></tr><tr><td align="left">scan</td><td align="left">付款码支付成功,返回支付订单信息</td></tr><tr><td align="left">wxplugin</td><td align="left">返回要拉起的微信小程序插件参数,<br>用于未开通支付能力的小程序发起支付,</td></tr><tr><td align="left">wxapp</td><td align="left">返回要拉起的微信小程序和路径,<br>用于APP内拉起微信小程序支付</td></tr></tbody></table>
hechu
2024年5月23日 09:08
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档(打印)
分享
链接
类型
密码
更新密码