# 申请信用卡接口

### 申请下单 <a href="#bntnn7" id="bntnn7"></a>

商户业务系统通过申请信用卡接口发起申请订单，BePay支付网关会根据商户配置的信用卡通道路由信用卡通道完成申请信用卡下单。网关根据不同的申请方式返回对应的申请状态。

> 接口说明

适用对象：`普通商户` `特约商户`

请求URL：[https://](https://pay.jeepay.vip/api/pay/unifiedOrder)**{BePay Domain}**/api/applyCreditOrder

请求方式：`POST`

请求类型：`application/json` 或 `application/x-www-form-urlencoded`

> 请求参数

<table><thead><tr><th width="140">字段名</th><th width="143">变量名</th><th width="67">必填</th><th width="122">类型</th><th>示例值</th><th>描述</th></tr></thead><tbody><tr><td>商户号</td><td>mchNo</td><td>是</td><td>String(30)</td><td>M1621873433953</td><td>商户号</td></tr><tr><td>应用ID</td><td>appId</td><td>是</td><td>String(24)</td><td>60cc09bce4b0f1c0b83761c9</td><td>应用ID</td></tr><tr><td>商户订单号</td><td>mchOrderNo</td><td>是</td><td>String(30)</td><td>20160427210604000490</td><td>商户生成的订单号</td></tr><tr><td>商户用户ID</td><td>mchUserId</td><td>是</td><td>String</td><td>234562345</td><td>商户处的用户ID(<mark style="color:red;">唯一ID)</mark></td></tr><tr><td>信用卡类型</td><td>creditType</td><td>是</td><td>int</td><td>1</td><td>通过【获取信用卡类型列表接口】而得到</td></tr><tr><td>申请信用卡手续费扣除的币种</td><td>applyFeeSymbol</td><td>是</td><td>String</td><td>USDT</td><td>扣除申请手续费的币种（当前仅支持<mark style="color:red;">USDT</mark>）</td></tr><tr><td>信用卡类型配置ID</td><td>configId</td><td>是</td><td>Long</td><td>1</td><td>通过【获取信用卡类型列表接口】而得到</td></tr><tr><td>申请用户的姓</td><td>firstName</td><td>否</td><td>String</td><td>xiao</td><td>申请用户的姓</td></tr><tr><td>申请用户的名字</td><td>lastName</td><td>是</td><td>String</td><td>ming</td><td>申请用户的名字</td></tr><tr><td>手机区号</td><td>phoneCode</td><td>否</td><td>String</td><td>86</td><td>手机区号</td></tr><tr><td>商户用户的手机号</td><td>mchUserPhone</td><td>否</td><td>String</td><td>123456789</td><td>商户用户的手机号</td></tr><tr><td>商户用户的邮箱</td><td>mchUserEmail</td><td>否</td><td>String</td><td>12356@gmail.com</td><td>商户用户的邮箱</td></tr><tr><td>商户用户的地址</td><td>mchUserAddress</td><td>否</td><td>String</td><td>南京路</td><td>商户用户的地址</td></tr><tr><td>商户用户所在的城市</td><td>mchUserCity</td><td>否</td><td>String</td><td>南京 </td><td>商户用户所在的城市</td></tr><tr><td>商户用户所在的区域</td><td>mchUserState</td><td>否</td><td>String</td><td>江苏</td><td>商户用户所在的区域（省/州/自治区）</td></tr><tr><td>商户用户所在的国家</td><td>mchUserCountry</td><td>否</td><td>String</td><td>中国</td><td>商户用户所在的国家</td></tr><tr><td>商户用户所在地的邮编</td><td>mchUserPostalCode</td><td>否</td><td>String</td><td>10001</td><td>商户用户所在地的邮编</td></tr><tr><td>信用卡的卡段</td><td>providerCardId</td><td>否</td><td>String</td><td>1234</td><td>信用卡的卡段（仅<mark style="color:red;">申请物理卡</mark>需要）</td></tr><tr><td>信用额度金额</td><td>quotaAmount</td><td>是</td><td>BigDecimal</td><td>100.00</td><td>信用额度金额</td></tr><tr><td>申请备注</td><td>applyDesc</td><td>是</td><td>String</td><td>网购</td><td>申请备注</td></tr><tr><td>是否后台审核</td><td>audit</td><td>是</td><td>Boolean</td><td>false</td><td>是否后台审核</td></tr><tr><td>异步回调地址</td><td>notifyUrl</td><td>是</td><td>String(3)</td><td>http://bepay.one</td><td>异步回调地址</td></tr><tr><td>特定提供商的额外can sh参数</td><td>channelExtra</td><td>否</td><td>String</td><td>{“auth_code”:“13920933111042”}</td><td>特定渠道发起的额外参数,json格式字符串.详见</td></tr><tr><td>扩展参数</td><td>extParam</td><td>否</td><td>String(512)</td><td>134586944573118714</td><td>商户扩展参数,回调时会原样返回</td></tr><tr><td>签名</td><td>sign</td><td>是</td><td>String(32)</td><td>C380BEC2BFD727A4B6845133519F3AD6</td><td>签名值，详见签名算法</td></tr></tbody></table>

`请求示例数据`

```json
{
  "mchNo": "M1623984572",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "mchOrderNo": "mho1624005107281",
  "mchUserId": "234562345",
  "creditType": 1,
  "applyFeeSymbol": "USDT",
  "configId": 1,
  "firstName": "xiao",
  "lastName": "ming",
  "phoneCode": "86",
  "mchUserPhone": "123456789",
  "mchUserEmail": "12314@gmail.com",
  "mchUserAddress": "南京路",
  "mchUserCity": "南京",
  "mchUserState": "江苏",
  "mchUserCountry": "中国",
  "mchUserPostalCode": "1001",
  "quotaAmount": 100.00,
  "applyDesc": "test",
  "audit": false,
  "notifyUrl": "https://www.bepay.one",
  "channelExtra": "{\"authCode\":\"280812820366966512\"}",
  "extParam": "",
  "sign": "84F606FA25A6EC4783BECC08D4FDC681",
}
```

> 返回参数

<table><thead><tr><th width="111">字段名</th><th width="81">变量名</th><th>必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead><tbody><tr><td>返回状态</td><td>code</td><td>是</td><td>int</td><td>0</td><td>0-处理成功，其他-处理有误，<a href="../fu-jian-cuo-wu-ma">详见错误码</a></td></tr><tr><td>返回信息</td><td>msg</td><td>否</td><td>String(128)</td><td>签名失败</td><td>具体错误原因，例如：签名失败、参数格式校验错误</td></tr><tr><td>签名信息</td><td>sign</td><td>否</td><td>String(32)</td><td>CCD9083A6DAD9A2DA9F668C3D4517A84</td><td>对data内数据签名,如data为空则不返回</td></tr><tr><td>返回数据</td><td>data</td><td>否</td><td>String(512)</td><td>{}</td><td>返回下单数据,json格式数据</td></tr></tbody></table>

`data数据格式`

<table><thead><tr><th width="137">字段名</th><th>变量名</th><th width="67">必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead><tbody><tr><td>申请订单号</td><td>applyId</td><td>是</td><td>String(30)</td><td>CA12021022311124442600</td><td>返回申请订单号</td></tr><tr><td>商户订单号</td><td>mchOrderNo</td><td>是</td><td>String(30)</td><td>20160427210604000490</td><td>返回商户传入的订单号</td></tr><tr><td>商户用户ID</td><td>mchUserId</td><td>是</td><td>String</td><td>234562345</td><td>商户用户ID</td></tr><tr><td>订单状态</td><td>state</td><td>是</td><td>int</td><td>2</td><td>支付订单状态<br>0-订单生成<br>1-申请中<br>2-申请成功<br>3-申请失败<br>4-已撤销<br>5-订单关闭</td></tr><tr><td>渠道订单号</td><td>channelOrderNo</td><td>是</td><td>String</td><td>d2395857382</td><td>渠道订单号</td></tr><tr><td>渠道错误码</td><td>errCode</td><td>否</td><td>String</td><td>ACQ.PAYMENT_AUTH_CODE_INVALID</td><td>上游渠道返回的错误码</td></tr><tr><td>渠道错误描述</td><td>errMsg</td><td>否</td><td>String</td><td>Business Failed 失败</td><td>上游渠道返回的错误描述</td></tr></tbody></table>
