兑换系统开放接口


批量直充

<h3>批量直充</h3> <p><strong>URL:</strong> /v1/openapi/order/batch</p> <p><strong>Type:</strong> POST</p> <p><strong>Content-Type:</strong> application/json; charset=utf-8</p> <p><strong>Description:</strong> 批量直充</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>batchBizCode</td> <td>string</td> <td>批充流水号</td> <td>true</td> <td>-</td> </tr> <tr> <td>productCode</td> <td>string</td> <td>商品编码</td> <td>true</td> <td>-</td> </tr> <tr> <td>callbackUrl</td> <td>string</td> <td>充值的状态报告推送地址&lt;br&gt;为空则使用开户时设置的地址</td> <td>false</td> <td>-</td> </tr> <tr> <td>itemList</td> <td>array</td> <td>充值明细</td> <td>false</td> <td>-</td> </tr> <tr> <td>└─bizCode</td> <td>string</td> <td>商家订单号</td> <td>true</td> <td>-</td> </tr> <tr> <td>└─account</td> <td>string</td> <td>账号:加油卡、银行卡等</td> <td>true</td> <td>-</td> </tr> <tr> <td>└─accountAttachValues</td> <td>string</td> <td>附加信息值,不同产品附加值不同,具体参考《直充附加值字典》</td> <td>false</td> <td>-</td> </tr> <tr> <td>└─spec</td> <td>number</td> <td>充值面额-商品不是固定面额的需要传(如支付宝现金红包)</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/order/batch? --data '{ &amp;quot;merchantId&amp;quot;: &amp;quot;196&amp;quot;, &amp;quot;businessId&amp;quot;: &amp;quot;196&amp;quot;, &amp;quot;batchBizCode&amp;quot;: &amp;quot;54092&amp;quot;, &amp;quot;productCode&amp;quot;: &amp;quot;54092&amp;quot;, &amp;quot;callbackUrl&amp;quot;: &amp;quot;www.xn---xn--sov-us2pt48k.org&amp;quot;, &amp;quot;itemList&amp;quot;: [ { &amp;quot;bizCode&amp;quot;: &amp;quot;54092&amp;quot;, &amp;quot;account&amp;quot;: &amp;quot;kqfimo&amp;quot;, &amp;quot;accountAttachValues&amp;quot;: &amp;quot;smybqv&amp;quot;, &amp;quot;spec&amp;quot;: 795 } ] }'</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>└─orderCode</td> <td>string</td> <td>平台订单号</td> <td>-</td> </tr> <tr> <td>└─bizCode</td> <td>string</td> <td>商家订单号</td> <td>-</td> </tr> <tr> <td>└─settlementPrice</td> <td>number</td> <td>结算金额</td> <td>-</td> </tr> </tbody> </table> <p><strong>Response-example:</strong></p> <pre><code>{ &amp;quot;status&amp;quot;: 170, &amp;quot;message&amp;quot;: &amp;quot;success&amp;quot;, &amp;quot;data&amp;quot;: [ { &amp;quot;orderCode&amp;quot;: &amp;quot;54092&amp;quot;, &amp;quot;bizCode&amp;quot;: &amp;quot;54092&amp;quot;, &amp;quot;settlementPrice&amp;quot;: 476 } ] }</code></pre>

页面列表

ITEM_HTML