UPI代收
<p>简要描述:</p>
<ul>
<li>请求收款/还款</li>
<li>唤醒用户手机带有UPI账户的APP,用户选择好APP之后进入到APP进行支付</li>
</ul>
<p><strong>注意事项:</strong></p>
<p><strong>1:token的有效期是30min</strong></p>
<p><strong>2:用户在SDK弹出的APP选框中,如果不小心点了取消。用户在重新发起支付请求的时候,在30min内,一样可以用上一次生成的token(前提是订单在MPurse这边没有订单的最终状态。可以在用上一次生成的token时,主动查询MPurse订单结果),避免重复生成订单。</strong></p>
<p>接口名</p>
<p><strong>upiQrCollect</strong></p>
<p><strong>接口请求参数:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">金额,最多两位小数</td>
</tr>
<tr>
<td style="text-align: left;">cMobile</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string(10)</td>
<td style="text-align: left;">用户手机号,10位数字,以5、6、7、8、9开头,如果用户输入了区号+91,则需要去除</td>
</tr>
<tr>
<td style="text-align: left;">cName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string(40)</td>
<td style="text-align: left;">用户姓名,仅允许英文和空格</td>
</tr>
<tr>
<td style="text-align: left;">txnId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string(50)</td>
<td style="text-align: left;">商户订单ID, 商户端生成(仅允许字母及数字,不区分大小写)</td>
</tr>
<tr>
<td style="text-align: left;">product</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">alphanumeric(100)</td>
<td style="text-align: left;">商品名称,仅英文,数字,及空格</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">alphanumeric(100)</td>
<td style="text-align: left;">备注,仅英文,数字,及空格</td>
</tr>
</tbody>
</table>
<p><strong>请求示例:</strong></p>
<pre><code> {
"amount": "2000",
"cMobile": "8884561110",
"cName": "Modi",
"txnId": "316278361248",
"product": "test",
"remark": "test"
}
</code></pre>
<p><strong>响应参数:</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">txnId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">商户端生成的订单id</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">交易金额, 最多两位小数</td>
</tr>
<tr>
<td style="text-align: left;">mpRefId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">mpurse 端的关联订单id</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单状态:PENDING(处理中). TRANSACTION_SUCCESS(成功). TRANSACTION_FAILURE(失败). 正常情况下,状态返回是PENDING</td>
</tr>
<tr>
<td style="text-align: left;">token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">token值,需要发送给SDK,由SDK执行下一步</td>
</tr>
<tr>
<td style="text-align: left;">errorMsg</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">订单失败原因</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong></p>
<table>
<thead>
<tr>
<th style="text-align: left;">{</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">"status": "0000",</td>
</tr>
<tr>
<td style="text-align: left;">"message": "success",</td>
</tr>
<tr>
<td style="text-align: left;">"retBizParams": {</td>
</tr>
<tr>
<td style="text-align: left;">"txnId": "316278361248",</td>
</tr>
<tr>
<td style="text-align: left;">"status": "PENDING",</td>
</tr>
<tr>
<td style="text-align: left;">"mpRefId": "31789314242",</td>
</tr>
<tr>
<td style="text-align: left;">"amount": "2000",</td>
</tr>
<tr>
<td style="text-align: left;">"token": "dXBpOi8vcGF5P3BhPW1wdXJzZUBpY2ljaSZwbj1NUHVyc2UmdHI9RVpZMjAyMDA5MDgwNjQzMzg0Mzc0MjY0OSZhbT0xMDAuMDAmY3U9SU5SJm1jPTU0MTE=",</td>
</tr>
<tr>
<td style="text-align: left;">"errorMsg": "Transaction Initiated",</td>
</tr>
<tr>
<td style="text-align: left;">}</td>
</tr>
<tr>
<td style="text-align: left;">}</td>
</tr>
</tbody>
</table>