> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 申请提升限额

> 提交商户限额提升申请，通过额外的合规验证流程提高每日或每月交易上限。

当商户的业务需求超出其当前交易限额时，请使用此端点。提交此申请后将启动强化合规审查，商户可能需要提供额外文件——例如资金证明、营业执照或经审计的财务报表。审批通过后，商户的每日和每月限额将被更新，并体现在商户列表响应中。

> [!NOTE]
>
> 所有请求都必须包含 `X-BH-TOKEN` 请求头和 `Content-Type: application/json`。

## 端点

`POST https://api.velafi.com/v2/upgrade/limits`

## 请求参数

**merchantId** `number` *required*

申请提升限额的商户 ID。

**callbackUrl** `string` *required*

限额提升验证流程完成后 VelaFi 调用的 URL。

## 响应字段

**code** `number`

响应码。此端点成功时返回 `0`。

**msg** `string`

状态消息。成功时为 `success`。

**data** `object`

**data 字段**

**link** `string`

商户完成限额提升验证需要访问的托管页面 URL。

## 示例

```bash cURL theme={null}
curl -X POST https://api.velafi.com/v2/upgrade/limits \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantId": 151209,
    "callbackUrl": "https://your-app.com/limit-upgrade-callback"
  }'
```

```json Response theme={null}
{
  "code": 0,
  "msg": "success",
  "data": {
    "link": "https://www.velafi.com/verify?velafi_token=abc123"
  }
}
```

> [!NOTE]
>
> 通过轮询[商户列表](https://docs.velafi.com/cn/api-reference/merchant/get-a-list-of-merchants.md)响应中的 `upgradeMerchantLimitStatus` 字段，跟踪限额提升申请的结果。


## Related topics

- [更新日志](https://docs.velafi.com/cn/docs/changelog.md)
- [交易限额](https://docs.velafi.com/cn/docs/limits.md)
- [创建商户](https://docs.velafi.com/cn/docs/guides/creating-merchant.md)
- [商户](https://docs.velafi.com/cn/docs/merchants.md)
- [生成令牌](https://docs.velafi.com/cn/api-reference/generate-token.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.