订单支付相关数据接口约定
<h2>公共规则</h2>
<ul>
<li>签名规则: 略</li>
<li>请求方法: POST</li>
<li>请求体格式: json</li>
<li>响应体格式: json</li>
</ul>
<p>款项流转设计原则:</p>
<ul>
<li>付款由中升GO发起, 想用车向中升GO发送金额信息后, 将停留在待付款状态等待中升GO通知信息.</li>
<li>退款由想用车发起, 想用车向中升GO发送执行退款操作通知后, 停留在原状态等待等待中升GO通知信息.</li>
</ul>
<h3>想用车侧接口</h3>
<h4>支付成功通知接口</h4>
<p>当中升GO收到微信的支付成功通知回调时, 应调用此接口向想用车同步支付成功信息.</p>
<p>支付通知情景类型(type取值说明):</p>
<ul>
<li>rent: 租金支付, 小程序端用户确认订单后, 进入支付租金流程, 当租金支付成功之后, 使用此类型通知.</li>
<li>deposit: 押金支付, 小程序端进入押金支付流程后, 当完成押金支付时, 使用此类型通知.</li>
<li>
<p>makeup: 补交租金支付, 小程序端进入租金补交流程后, 用户支付完毕, 使用此类型通知.</p>
<p>同时, 因超期租金将由押金先行抵扣, 故, 若需补交, 则押金必已扣光,
补交完成之后, 订单将直接进入完成状态.</p>
</li>
</ul>
<pre><code>POST amount-payed
{
&quot;id&quot;: &quot;订单id&quot;,
&quot;type&quot;: &quot;款项类型&quot;,
&quot;realAmount&quot;: &quot;int&quot; // 实付金额, 单位: 分.
}</code></pre>
<p>响应信息:</p>
<p>状态码200, 响应体可忽略.</p>
<h3>中升GO侧接口</h3>
<p><b style="color:red">注意: 若请求未能正常返回, 流程将被阻断, 并向前端返回: "系统繁忙". </b></p>
<p><b style="color:red">或可另行约定异常情形及前端回显信息.</b></p>
<h4>押金金额同步接口</h4>
<p>用户订单由经销店审核通过后, 经销店会录入押金金额.</p>
<ul>
<li>若为0, 则跳过押金相关步骤, 此接口将不会被调用.</li>
<li>若有押金金额, 将通过此接口向中升GO后台同步金额, 以备收取押金使用.</li>
</ul>
<pre><code>POST set-order-deposit
{
&quot;id&quot;: &quot;订单id&quot;,
&quot;deposit&quot;: &quot;int&quot; // 押金金额, 单位: 分.
}</code></pre>
<p>响应格式:</p>
<p>允许状态码为200或204, 请求体可空或为任意(将被忽略).</p>
<h4>补交租金同步接口</h4>
<p>用户还车时, 若需要补交租金, 将调用此接口向中升GO同步补交金额</p>
<pre><code>POST set-order-makeup
{
&quot;id&quot;: &quot;订单id&quot;,
&quot;hours&quot;: &quot;int&quot;, // 超时时间, 单位: 小时.
&quot;unitPrice&quot;: &quot;int&quot;, // 租金每小时单价, 单位: 分.
&quot;totalPrice&quot;: &quot;int&quot;, // 需补交租金总额, 单位: 分.
}</code></pre>
<p>响应格式:</p>
<p>允许状态码为200或204, 请求体可空或为任意(将被忽略).</p>
<h4>退款接口</h4>
<p>若有款项需要退还用户, 将调用此接口, 由中升GO向微信发起退款.</p>
<p>退款情景类型(type取值说明):</p>
<ul>
<li>rent: 退还租金, 用户还车, 审核拒绝, 订单取消等情形, 若需要退还租金, 使用此类型发起.</li>
<li>deposit: 退还押金, 用户还车, 订单取消等情形, 若需要退还押金, 使用此类型发起.</li>
</ul>
<pre><code>POST amount-refund
{
&quot;id&quot;: &quot;订单id&quot;,
&quot;type&quot;: &quot;款项类型&quot;,
&quot;amount&quot;: &quot;int&quot;, // 退款金额, 单位: 分.
}</code></pre>
<p>响应格式:</p>
<p>若发起退款流程正常或异常, 由中升GO方确定响应格式.</p>
<p>若响应为退款成功, 想用车侧将继续订单流程.
若出现异常, 视具体情况另行协商.</p>