# 26.卡片充值-1.0

## URL

/api/v1.0/card/recharge

{% hint style="info" %}

```
充值情形描述：
```

```json
（1）充值受理返回success
（2）充值受理返回false，errorCode为"BIZ_STATUS_ERROR"
     以上两种情况都需要补查，等待1到5分钟，等待webhook回调或调用“卡片订单信息查询”主动查询订单状态
————————————————————————————————————————————————————————————————————————————————
（3）其他失败情况表示充值受理失败，可查看返回错误码详情

充值终态均会webhook通知商户，也可通过“卡片订单信息查询”主动查询订单状态
```

{% endhint %}

## 请求参数

| **名称**    | 字段描述  | 字段**类型** | **必须** | **备注**       |
| --------- | ----- | -------- | ------ | ------------ |
| requestNo | 请求流水号 | String   | 必填     | 唯一，不可重复      |
| cardId    | 卡编号   | String   | 必填     | 开卡申请接口返回的卡编号 |
| amount    | 充值金额  | Number   | 必填     | <p><br></p>  |

## 请求示例

```json
{
  "custNo": "158519...017664",
  "request": {
    "amount": 100.00,
    "cardId": "221...0000001",
    "requestNo": "20222...240002"
  },
  "verify": "234rfre43...u763ewdft"
}
```

## 待签名字符串

```
"requestNo="+requestNo+"&cardId="+cardId+"&amount="+amount
```

## 响应结果

| **名称**  | 字段描述  | 字段**类型** | **必须** | **备注**      |
| ------- | ----- | -------- | ------ | ----------- |
| orderNo | 平台订单号 | String   | 必填     | <p><br></p> |

## 响应示例

```
{
  "errorCode":  null,
  "errorMsg": null,
  "result": "dafsdjfnh239u4....odnfb2i3ope",
  "success": true
}
```

## result解密后内容

```
2210200...23123
```