OnePay钱包支付代付对接文档

OnePay对接Api文档


支付

<h5>简要描述</h5> <ul> <li>创建支付订单</li> </ul> <h5>请求URL</h5> <ul> <li><code>http://onepayceshi5.icu/v1/payment/add</code> </li> </ul> <h5>请求方式</h5> <ul> <li>post</li> </ul> <h5>请求Body参数</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">示例值</th> <th>必选</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">merchantid</td> <td style="text-align: left;">202207208888</td> <td>是</td> <td>string</td> <td>商户ID,由OnePay统一支付分配。</td> </tr> <tr> <td style="text-align: left;">orderid</td> <td style="text-align: left;">20220720123456</td> <td>是</td> <td>string</td> <td>商户系统订单号,该订单号将作为OnePay 的返回数据。该值需在商户系统内唯一。</td> </tr> <tr> <td style="text-align: left;">amount</td> <td style="text-align: left;">100.00</td> <td>是</td> <td>number</td> <td>币数量 为了保证签名验证,请使用字符串接收后再转换为number类型</td> </tr> <tr> <td style="text-align: left;">notify_url</td> <td style="text-align: left;"><a href="http://test.com/notifyurl">http://test.com/notifyurl</a></td> <td>是</td> <td>string</td> <td>异步通知的地址</td> </tr> <tr> <td style="text-align: left;">return_url</td> <td style="text-align: left;"><a href="http://test.com">http://test.com</a></td> <td>否</td> <td>string</td> <td>支付成功后同步跳转地址,如果为空不参与签名</td> </tr> <tr> <td style="text-align: left;">remark</td> <td style="text-align: left;">remark</td> <td>否</td> <td>string</td> <td>商户备注,回调时原样返回 ,如果为空不参与签名</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">详见签名规则</td> <td>是</td> <td>string</td> <td>32位大写MD5签名值 ,详见签名规则</td> </tr> </tbody> </table> <h5>成功返回示例</h5> <pre><code>{ "code":"0000", "msg":"success", "data":{ "id":"9C48E0A5-BAAD-C3DA-A90B-22CA0DA125DD",//平台订单号 "orderid":"20220720235026732209",//商户号号 "merchantid":2022060100434708888,//商户号 "buyer":null,//出币方钱包地址 "amount":"200.000",//币数量 "charge":"0.400",//手续费 "remark":"test",//商户备注,回调时原样返回 "state":"0",// 0 为订单创建成功 "payurl":"https://localhost/order?id=9C48E0A5-BAAD-C3DA-A90B-22CA0DA125DD",//平台提供的支付页面,商户可直接导航用户浏览器打开该地址。 "notify_url":"https://test.com/notify",//异步回调地址 "return_url":"https://test.com/",//支付成功后,同步跳转地址 "addtime":"1658332237",//订单创建时间 "sign":""// 签名 } } </code></pre> <h5>成功返回示例的参数说明</h5> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">code</td> <td style="text-align: left;">string</td> <td>订单结果&quot;0000&quot;为成功,其他失败</td> </tr> <tr> <td style="text-align: left;">msg</td> <td style="text-align: left;">string</td> <td>返回失败时,错误信息</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">string</td> <td>成功时返回的数据,结果参考示例</td> </tr> </tbody> </table> <h5>失败返回示例</h5> <pre><code>{ "code":"10001" "msg":"fail" } </code></pre> <h5>备注</h5> <p>返回json格式</p>

页面列表

ITEM_HTML