兑换系统开放接口


获取授权链接

<h3>获取授权链接</h3> <p><strong>URL:</strong> /v1/openapi/auth/alipay/url</p> <p><strong>Type:</strong> POST</p> <p><strong>Content-Type:</strong> application/json; charset=utf-8</p> <p><strong>Description:</strong> 获取支付宝openId授权链接</p> <p><strong>Request-headers:</strong></p> <table> <thead> <tr> <th>Header</th> <th>Type</th> <th>Description</th> <th>Required</th> <th>Since</th> </tr> </thead> <tbody> <tr> <td>businessId</td> <td>string</td> <td>业务ID,由平台提供</td> <td>true</td> <td>-</td> </tr> <tr> <td>nonce</td> <td>string</td> <td>随机字符串,需保证每次请求不同</td> <td>true</td> <td>-</td> </tr> <tr> <td>timestamp</td> <td>string</td> <td>时间戳,毫秒值</td> <td>true</td> <td>-</td> </tr> <tr> <td>sign</td> <td>string</td> <td>签名值</td> <td>true</td> <td>-</td> </tr> <tr> <td>signType</td> <td>string</td> <td>签名方式:SHA256-RSA、MD5。默认:SHA256-RSA</td> <td>false</td> </tr> </tbody> </table> <p><strong>Body-parameters:</strong></p> <table> <thead> <tr> <th>Parameter</th> <th>Type</th> <th>Description</th> <th>Required</th> <th>Since</th> </tr> </thead> <tbody> <tr> <td>merchantId</td> <td>string</td> <td>商家ID</td> <td>true</td> <td>-</td> </tr> <tr> <td>businessId</td> <td>string</td> <td>业务ID</td> <td>true</td> <td>-</td> </tr> <tr> <td>serialNo</td> <td>string</td> <td>流水号(全局唯一)</td> <td>true</td> <td>-</td> </tr> <tr> <td>userId</td> <td>string</td> <td>商家客户唯一标识</td> <td>true</td> <td>-</td> </tr> <tr> <td>callbackUrl</td> <td>string</td> <td>授权回调地址,用来接收用户支付宝openId</td> <td>false</td> <td>-</td> </tr> </tbody> </table> <p><strong>Request-example:</strong></p> <pre><code>curl -X POST -H 'Content-Type: application/json; charset=utf-8' -H 'businessId:55' -H 'nonce:55' -H 'timestamp:1628757969177' -H 'sign:55' -i /v1/openapi/auth/alipay/url --data '{ &amp;quot;merchantId&amp;quot;: &amp;quot;19&amp;quot;, &amp;quot;businessId&amp;quot;: &amp;quot;19&amp;quot;, &amp;quot;serialNo&amp;quot;: &amp;quot;abcd&amp;quot;, &amp;quot;thirdAccount&amp;quot;: &amp;quot;user1&amp;quot;, &amp;quot;callbackUrl&amp;quot;: &amp;quot;www.xn---xn--7mz-rs30a.info&amp;quot; }'</code></pre> <p><strong>Response-fields:</strong></p> <table> <thead> <tr> <th>Field</th> <th>Type</th> <th>Description</th> <th>Since</th> </tr> </thead> <tbody> <tr> <td>status</td> <td>int32</td> <td>状态码</td> <td>-</td> </tr> <tr> <td>message</td> <td>string</td> <td>返回消息</td> <td>-</td> </tr> <tr> <td>data</td> <td>object</td> <td>数据对象</td> <td>-</td> </tr> <tr> <td>└─alipayAuthUrl</td> <td>string</td> <td>支付宝授权页面链接</td> <td>-</td> </tr> </tbody> </table> <p><strong>Response-example:</strong></p> <pre><code>{ &amp;quot;status&amp;quot;: 420, &amp;quot;message&amp;quot;: &amp;quot;success&amp;quot;, &amp;quot;data&amp;quot;: { &amp;quot;alipayAuthUrl&amp;quot;: “https://abc.com” } }</code></pre>

页面列表

ITEM_HTML