api支付接口-quick
<h5>简要描述</h5>
<ul>
<li>商家请求后，实时获取交易结果(有中间状态)，如果有上送asynUrl则会异步回调通知商户此笔交易的结果（强烈推荐）</li>
</ul>
<h5>请求URL</h5>
<ul>
<li>
<p>测试环境 <code>https://test-api.evenepay.com/api/pay/quick/directpay</code></p>
</li>
<li>正式环境 <code>https://api.evenepay.com/api/pay/quick/directpay</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>1) POST方法的提交和返回结果采用json格式</li>
<li>2) 字符集默认使用UTF-8，请勿使用其他字符集</li>
<li>3) 所有的请求到EVEN平台访问都是基于https</li>
<li>4) 系统参数默认会采用驼峰方式命名，如果有不明确的参数，请以文档中的参数命名为准（注意大小写）</li>
</ul>
<h5>body参数</h5>
<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>
<th style="text-align: left;">位置</th>
<th>说明</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">version</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>接口版本号</td>
<td>1.0</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>应用id</td>
<td>分配给商户应用的唯一标识</td>
</tr>
<tr>
<td style="text-align: left;">orderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>商户订单号</td>
<td>小于32个字符，必须唯一</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>支付金额</td>
<td>大于 0 的数值，保留两位小数,相应币种的最小金额为准</td>
</tr>
<tr>
<td style="text-align: left;">currency</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>支付币种</td>
</tr>
<tr>
<td style="text-align: left;">cardFirstName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>信用卡持卡人名</td>
</tr>
<tr>
<td style="text-align: left;">cardLastName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>信用卡持卡人姓</td>
</tr>
<tr>
<td style="text-align: left;">cardNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>信用卡卡号</td>
<td>最短 12 个字符，最长 19 个字符</td>
</tr>
<tr>
<td style="text-align: left;">cardExpireYear</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>信用卡过期日期-年</td>
<td>固定 4 个字符，YYYY</td>
</tr>
<tr>
<td style="text-align: left;">cardExpireMonth</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>信用卡过期日期-月</td>
<td>2 个字符，MM</td>
</tr>
<tr>
<td style="text-align: left;">cardCvv</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>信用卡安全码cvv</td>
<td>最短 3 个字符，最长 4 个字符</td>
</tr>
<tr>
<td style="text-align: left;">asyncUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>异步通知地址</td>
<td>外网能访问的网址</td>
</tr>
<tr>
<td style="text-align: left;">ts</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>请求时间</td>
<td>格式（10位时间戳）：1606874556</td>
</tr>
<tr>
<td style="text-align: left;">signInfo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td style="text-align: left;">签名字段</td>
</tr>
<tr>
<td style="text-align: left;">extra</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">json</td>
<td style="text-align: left;">body</td>
<td style="text-align: left;">支付附加信息</td>
<td>详见extra参数</td>
</tr>
</tbody>
</table>
<h5>extra参数：</h5>
<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>
<th>说明</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>订单自定义备注</td>
</tr>
<tr>
<td style="text-align: left;">ipAddress</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>消费者ip地址</td>
</tr>
<tr>
<td style="text-align: left;">email</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>消费者电子邮件</td>
</tr>
<tr>
<td style="text-align: left;">productName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>商品名称</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
"appId": "WC2dVb0xuI",
"version": "1.0",
"orderNo": "1223005",
"amount": "1.00",
"currency": "USD",
"refundAmount": "100",
"cardFirstName": "wang",
"cardLastName": "hha",
"cardNo": "4222222222222",
"cardExpireYear": "2022",
"cardExpireMonth": "11",
"cardCvv": "123",
"asyncUrl": "http://www.baidu.com",
"ts": "1563326332",
"signInfo": "http://www.baidu.com/dwadaw",
"extra": {
"productName": "goodsId",
"email": "2323@qq.com",
"ipAddress": "192.168.1.1"
}
}</code></pre>
<h5>返回参数说明</h5>
<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>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Integer</td>
<td style="text-align: left;">body</td>
<td>0:API业务执行正确，并返回正确结果, 非0:API错误代码，返回出错信息</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>返回信息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">object</td>
<td style="text-align: left;">body</td>
<td>code为0时,附带详细结果数据</td>
</tr>
</tbody>
</table>
<h5>返回业务参数说明</h5>
<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>
<th>位置</th>
<th>说明</th>
<th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">payType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>结果类型：1-非3D 2-3D</td>
</tr>
<tr>
<td style="text-align: left;">payHtml</td>
<td style="text-align: left;">条件</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>3D身份校验网页内容</td>
<td>结果类型为2时出现，需要解码，与payUrl必定返回其中之一</td>
</tr>
<tr>
<td style="text-align: left;">payUrl</td>
<td style="text-align: left;">条件</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>3D身份交易跳转地址</td>
<td>结果类型为2时出现，需要解码，与payHtml必定返回其中之一</td>
</tr>
<tr>
<td style="text-align: left;">orderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>body</td>
<td>商户订单号</td>
</tr>
<tr>
<td style="text-align: left;">serialNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>body</td>
<td>平台订单流水号</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>body</td>
<td>支付金额</td>
</tr>
<tr>
<td style="text-align: left;">currency</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>body</td>
<td>支付币种</td>
</tr>
<tr>
<td style="text-align: left;">payStatus</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>body</td>
<td>支付提交状态</td>
<td>详见：附录-payStatus状态</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">body</td>
<td style="text-align: left;">string</td>
<td>商户订单自定义信息</td>
</tr>
<tr>
<td style="text-align: left;">ts</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>body</td>
<td>响应时间</td>
<td>格式（10位时间戳）：1645325325</td>
</tr>
<tr>
<td style="text-align: left;">signInfo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">body</td>
<td>验签字段</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
"code": "0",
"msg": "success",
"data": {
"payType": "1",
"payHtml": "",
"payUrl": "",
"orderNo": "1223005",
"serialNo": "1341668555904061442",
"amount": "1.00",
"currency": "USD",
"payStatus": "SUCCESS",
"ts": "1608713692",
"signInfo": "b79e64748a1b81112b14c6fd7b781cab10c0b29b5799ba399de97c60c0d35d7e"
}
}</code></pre>