兑换系统开放接口


加油卡直充

<h3>加油卡直充</h3> <p><strong>URL:</strong> /v1/openapi/order/gasCard</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>mobile</td> <td>string</td> <td>手机号</td> <td>false</td> <td>-</td> </tr> <tr> <td>account</td> <td>string</td> <td>加油卡号</td> <td>true</td> <td>-</td> </tr> <tr> <td>cardType</td> <td>string</td> <td>加油卡类型<br>ZSH (中石化)、ZSY(中石油)</td> <td>true</td> <td>-</td> </tr> <tr> <td>spec</td> <td>int32</td> <td>充值面额(单位元)</td> <td>true</td> <td>-</td> </tr> <tr> <td>bizCode</td> <td>string</td> <td>商家订单号</td> <td>true</td> <td>-</td> </tr> <tr> <td>callbackUrl</td> <td>string</td> <td>充值的状态报告推送地址<br>为空则使用开户时设置的地址</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/gasCard? --data '{ "merchantId": "19", "businessId": "19", "mobile": "17780120049", "account": "8fjz3w", "cardType": "csjc3i", "spec": 2, "bizCode": "33976", "callbackUrl": "www.xn---xn--7mz-rs30a.info" }'</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>{ "status": 532, "message": "success", "data": { "orderCode": "33976", "bizCode": "33976", "settlementPrice": 855 } }</code></pre>

页面列表

ITEM_HTML