# 信用卡出金接口

### 加密货币出金下单 <a href="#bntnn7" id="bntnn7"></a>

商户业务系统通过加密货币出金接口发起信用卡出金。BePay网关根据不同的加密货币类型向对应的信用卡账户发起出金操作，将信用卡账户中的余额提取为对应商户的用户账户中的加密货币。

> 接口说明

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

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

请求方式：`POST`

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

> 请求参数

<table><thead><tr><th width="140">字段名</th><th width="138">变量名</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>wayCode</td><td>是</td><td>String(30)</td><td>PIX</td><td>支付方式,如巴西支付 PIX,详细见【<a href="../fa-bi-zhi-fu-jie-kou/fu-jian-zhi-fu-fang-shi"><mark style="color:blue;">附件：支付方式</mark></a>】分页</td></tr><tr><td>订单金额</td><td>amount</td><td>是</td><td>BigDecimal</td><td>100.00</td><td>订单金额（固定保留<mark style="color:red;">2位小数</mark>）</td></tr><tr><td>货币代码</td><td>currency</td><td>是</td><td>String(3)</td><td>cny</td><td>三位货币代码,人民币:cny，详细见：【<a href="../fu-jian-huo-bi-dai-ma">附件：<mark style="color:blue;">货币代码</mark></a>】分页</td></tr><tr><td>客户端IP</td><td>clientIp</td><td>否</td><td>String(32)</td><td>210.73.10.148</td><td>客户端IPV4地址</td></tr><tr><td>商品标题</td><td>subject</td><td>是</td><td>String(64)</td><td>商品标题测试</td><td>商品标题</td></tr><tr><td>商品描述</td><td>body</td><td>是</td><td>String(256)</td><td>商品描述测试</td><td>商品描述</td></tr><tr><td>异步通知地址</td><td>notifyUrl</td><td>否</td><td>String(256)</td><td><a href="https://www.jeequan.com/notify.htm">https://www.jeequan.com/notify.htm</a></td><td>支付结果异步回调URL,只有传了该值才会发起回调</td></tr><tr><td>跳转通知地址</td><td>returnUrl</td><td>否</td><td>String(256)</td><td><a href="https://www.jeequan.com/return.htm">https://www.jeequan.com/return.htm</a></td><td>支付结果同步跳转通知URL</td></tr><tr><td>失效时间</td><td>expiredTime</td><td>否</td><td>int</td><td>3600</td><td>订单失效时间,单位秒,默认2小时.订单在(创建时间+失效时间)后失效</td></tr><tr><td>额外参数</td><td>channelExtra</td><td>否</td><td>String(256</td><td>{“auth_code”:“13920933111042”}</td><td>特定渠道发起的额外参数,json格式字符串.详见<a href="../fa-bi-zhi-fu-jie-kou/fu-jian-zhi-fuewai-can-shu">附件：支付额外参数</a></td></tr><tr><td>分账模式</td><td>divisionMode</td><td>否</td><td>int</td><td>0</td><td>分账模式： 0-该笔订单不允许分账[默认], 1-支付成功按配置自动完成分账, 2-商户手动分账(解冻商户金额)</td></tr><tr><td>扩展参数</td><td>extParam</td><td>否</td><td>String(512)</td><td>134586944573118714</td><td>商户扩展参数,回调时会原样返回</td></tr><tr><td>请求时间</td><td>reqTime</td><td>是</td><td>long</td><td>1622016572190</td><td>请求接口时间,13位时间戳</td></tr><tr><td>接口版本</td><td>version</td><td>是</td><td>String(3)</td><td>1.0</td><td>接口版本号，固定：1.0</td></tr><tr><td>签名</td><td>sign</td><td>是</td><td>String(32)</td><td>C380BEC2BFD727A4B6845133519F3AD6</td><td>签名值，详见签名算法</td></tr><tr><td>签名类型</td><td>signType</td><td>是</td><td>String(32)</td><td>MD5</td><td>签名类型，目前只支持MD5方式</td></tr></tbody></table>

`请求示例数据`

```json
{
  "amount": 100.00,
  "extParam": "",
  "mchOrderNo": "mho1624005107281",
  "mchUserId": "234562345",
  "subject": "商品标题",
  "wayCode": "ALI_BAR",
  "sign": "84F606FA25A6EC4783BECC08D4FDC681",
  "reqTime": "1624005107",
  "body": "商品描述",
  "version": "1.0",
  "channelExtra": "{\"authCode\":\"280812820366966512\"}",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "clientIp": "192.166.1.132",
  "notifyUrl": "https://www.jeequan.com",
  "signType": "MD5",
  "currency": "cny",
  "returnUrl": "",
  "mchNo": "M1623984572",
  "divisionMode": 1
}
```

> 返回参数

<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>payOrderId</td><td>是</td><td>String(30)</td><td>U12021022311124442600</td><td>返回支付系统订单号</td></tr><tr><td>商户订单号</td><td>mchOrderNo</td><td>是</td><td>String(30)</td><td>20160427210604000490</td><td>返回商户传入的订单号</td></tr><tr><td>订单状态</td><td>orderState</td><td>是</td><td>int</td><td>2</td><td>支付订单状态<br>0-订单生成<br>1-支付中<br>2-支付成功<br>3-支付失败<br>4-已撤销<br>5-已退款<br>6-订单关闭</td></tr><tr><td>支付数据类型</td><td>payDataType</td><td>是</td><td>String</td><td>payUrl</td><td>详见下方：payDataType说明</td></tr><tr><td>支付数据</td><td>payData</td><td>否</td><td>String</td><td><a href="http://www.jeequan.com/pay.html">http://www.jeequan.com/pay.html</a></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>

`data数据数据中`payDataType详细说明

### 法币出金下单 <a href="#bntnn7" id="bntnn7"></a>

商户业务系统通过法币出金接口发起信用卡出金。BePay网关根据不同的国家法定货币类型向对应的信用卡账户发起出金操作，将信用卡账户中的余额提取为对应商户的用户账户中的法币。（<mark style="color:red;">该接口暂时无法使用</mark>）

> 接口说明

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

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

请求方式：`POST`

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

> 请求参数

<table><thead><tr><th width="140">字段名</th><th width="138">变量名</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>wayCode</td><td>是</td><td>String(30)</td><td>PIX</td><td>支付方式,如巴西支付 PIX,详细见【<a href="../fa-bi-zhi-fu-jie-kou/fu-jian-zhi-fu-fang-shi"><mark style="color:blue;">附件：支付方式</mark></a>】分页</td></tr><tr><td>订单金额</td><td>amount</td><td>是</td><td>BigDecimal</td><td>100.00</td><td>订单金额（固定保留<mark style="color:red;">2位小数</mark>）</td></tr><tr><td>货币代码</td><td>currency</td><td>是</td><td>String(3)</td><td>cny</td><td>三位货币代码,人民币:cny，详细见：【<a href="../fu-jian-huo-bi-dai-ma">附件：<mark style="color:blue;">货币代码</mark></a>】分页</td></tr><tr><td>客户端IP</td><td>clientIp</td><td>否</td><td>String(32)</td><td>210.73.10.148</td><td>客户端IPV4地址</td></tr><tr><td>商品标题</td><td>subject</td><td>是</td><td>String(64)</td><td>商品标题测试</td><td>商品标题</td></tr><tr><td>商品描述</td><td>body</td><td>是</td><td>String(256)</td><td>商品描述测试</td><td>商品描述</td></tr><tr><td>异步通知地址</td><td>notifyUrl</td><td>否</td><td>String(256)</td><td><a href="https://www.jeequan.com/notify.htm">https://www.jeequan.com/notify.htm</a></td><td>支付结果异步回调URL,只有传了该值才会发起回调</td></tr><tr><td>跳转通知地址</td><td>returnUrl</td><td>否</td><td>String(256)</td><td><a href="https://www.jeequan.com/return.htm">https://www.jeequan.com/return.htm</a></td><td>支付结果同步跳转通知URL</td></tr><tr><td>失效时间</td><td>expiredTime</td><td>否</td><td>int</td><td>3600</td><td>订单失效时间,单位秒,默认2小时.订单在(创建时间+失效时间)后失效</td></tr><tr><td>额外参数</td><td>channelExtra</td><td>否</td><td>String(256</td><td>{“auth_code”:“13920933111042”}</td><td>特定渠道发起的额外参数,json格式字符串.详见<a href="../fa-bi-zhi-fu-jie-kou/fu-jian-zhi-fuewai-can-shu">附件：支付额外参数</a></td></tr><tr><td>分账模式</td><td>divisionMode</td><td>否</td><td>int</td><td>0</td><td>分账模式： 0-该笔订单不允许分账[默认], 1-支付成功按配置自动完成分账, 2-商户手动分账(解冻商户金额)</td></tr><tr><td>扩展参数</td><td>extParam</td><td>否</td><td>String(512)</td><td>134586944573118714</td><td>商户扩展参数,回调时会原样返回</td></tr><tr><td>请求时间</td><td>reqTime</td><td>是</td><td>long</td><td>1622016572190</td><td>请求接口时间,13位时间戳</td></tr><tr><td>接口版本</td><td>version</td><td>是</td><td>String(3)</td><td>1.0</td><td>接口版本号，固定：1.0</td></tr><tr><td>签名</td><td>sign</td><td>是</td><td>String(32)</td><td>C380BEC2BFD727A4B6845133519F3AD6</td><td>签名值，详见签名算法</td></tr><tr><td>签名类型</td><td>signType</td><td>是</td><td>String(32)</td><td>MD5</td><td>签名类型，目前只支持MD5方式</td></tr></tbody></table>

`请求示例数据`

```json
{
  "amount": 100.00,
  "extParam": "",
  "mchOrderNo": "mho1624005107281",
  "mchUserId": "234562345",
  "subject": "商品标题",
  "wayCode": "ALI_BAR",
  "sign": "84F606FA25A6EC4783BECC08D4FDC681",
  "reqTime": "1624005107",
  "body": "商品描述",
  "version": "1.0",
  "channelExtra": "{\"authCode\":\"280812820366966512\"}",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "clientIp": "192.166.1.132",
  "notifyUrl": "https://www.jeequan.com",
  "signType": "MD5",
  "currency": "cny",
  "returnUrl": "",
  "mchNo": "M1623984572",
  "divisionMode": 1
}
```

> 返回参数

<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>payOrderId</td><td>是</td><td>String(30)</td><td>U12021022311124442600</td><td>返回支付系统订单号</td></tr><tr><td>商户订单号</td><td>mchOrderNo</td><td>是</td><td>String(30)</td><td>20160427210604000490</td><td>返回商户传入的订单号</td></tr><tr><td>订单状态</td><td>orderState</td><td>是</td><td>int</td><td>2</td><td>支付订单状态<br>0-订单生成<br>1-支付中<br>2-支付成功<br>3-支付失败<br>4-已撤销<br>5-已退款<br>6-订单关闭</td></tr><tr><td>支付数据类型</td><td>payDataType</td><td>是</td><td>String</td><td>payUrl</td><td>详见下方：payDataType说明</td></tr><tr><td>支付数据</td><td>payData</td><td>否</td><td>String</td><td><a href="http://www.jeequan.com/pay.html">http://www.jeequan.com/pay.html</a></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>

`data数据数据中`payDataType详细说明
