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

# Configure withdrawal limits

**Available to roles**: <Badge color="blue">Owner</Badge>

Withdrawal limits can be configured by users with the Owner role to send outgoing transactions for manual approval when they exceed a configured threshold. Limits are configured separately for **interface withdrawals** (created in the merchant dashboard) and **API withdrawals** (created via the API).

When an interface withdrawal exceeds a configured limit, it must be approved by a **different** user with the Owner role — the user who created the withdrawal cannot approve it themselves. For API withdrawals, any user with Owner permissions can approve or decline the transaction.

There are two types of limits:

* **Default limit** — set in your account's main fiat currency (typically EUR) and applies to all currencies. Withdrawals in other currencies are checked against their EUR equivalent. For example, a default limit of 1,000 EUR means any USDC withdrawal over 1,166.70 USDC (≈ 1,000 EUR) will require approval.
* **Custom limit** — set for a specific currency and overrides the default limit. For example, if you set a custom USDC limit of 10,000 USDC, a 1,166.70 USDC withdrawal will no longer require approval, even if it exceeds the default EUR threshold.

<Warning>
  Withdrawal limits do not apply to fiat withdrawals to bank accounts.
</Warning>

## Configure the default withdrawal limit

The default limit is defined in your account's main fiat currency (typically EUR) and applies to all currencies. Withdrawals in other currencies are evaluated based on their EUR equivalent — for example, with a default limit of 1,000 EUR, a USDC withdrawal over 1,166.70 USDC (the equivalent of 1,000 EUR) would require approval. To set a different threshold for a specific currency, configure a custom limit for that currency instead.

<Steps>
  <Step title="In your merchant dashboard, go to Settings and open the Withdrawal limit tab." />

  <Step title="Select the withdrawal type">
    Select the **Interface withdrawals** tab to set limits for withdrawals created in the merchant dashboard, or the **API withdrawals** tab for withdrawals created via the API.
  </Step>

  <Step title="In the Default interface/API withdrawal's limit section, click Edit." />

  <Step title="Configure the limit options.">
    In the pop-up, configure any of the following options:

    * **All withdrawals will be passed through manual moderation** — enable this checkbox to require approval for all withdrawals regardless of amount.
    * **One operation limit** — maximum amount per single withdrawal.
    * **Per hour limit** — maximum total amount within one hour.
    * **Per day limit** — maximum total amount within one day.
  </Step>

  <Step title="Enter your 2FA code and click Submit." />
</Steps>

## Configure custom withdrawal limits

Custom limits apply to a specific currency and take priority over the default limit. Use custom limits when you need different thresholds for individual fiat or crypto currencies.

<Steps>
  <Step title="In your merchant dashboard, go to Settings and open the Withdrawal limit tab." />

  <Step title="Select the withdrawal type.">
    Select the **Interface withdrawals** tab to set limits for withdrawals created in the merchant dashboard, or the **API withdrawals** tab for withdrawals created via the API.
  </Step>

  <Step title="In the Custom interface/API withdrawal's limit section, click Add limit." />

  <Step title="Configure the limit options.">
    In the pop-up, configure the following:

    * **Currency** — select the fiat or crypto currency for this limit.
    * **All withdrawals will be passed through manual moderation** — enable this checkbox to require approval for all withdrawals in this currency regardless of amount.
    * **One operation limit** — maximum amount per single withdrawal.
    * **Per hour limit** — maximum total amount within one hour.
    * **Per day limit** — maximum total amount within one day.
  </Step>

  <Step title="Enter your 2FA code and click Submit." />
</Steps>

## Configure notifications for pending approvals

You can configure email notifications to alert you when a withdrawal is sent for manual moderation.

<Steps>
  <Step title="In your merchant dashboard, go to Settings, open the Withdrawal limit tab, then select the Notifications tab." />

  <Step title="Add email addresses.">
    Click **Email** and enter the email address where you want to receive notifications. To add multiple addresses, click **Add** after each entry. To remove an address, click the bin icon next to it.
  </Step>

  <Step title="Enter your 2FA code and click Submit." />

  <Step title="Send a test notification.">
    Click **Test email** to send a test notification to all configured addresses and confirm delivery.
  </Step>
</Steps>

## FAQ

### Can I require approval for all withdrawals regardless of amount?

Yes. When editing the default limit, enable the **All withdrawals will be passed through manual moderation** checkbox. Every withdrawal will then be sent for approval regardless of amount.

Note that this setting is configured independently for interface withdrawals and API withdrawals — if you want it to apply to both, enable it in each tab.

### Can I require approval for all withdrawals in a specific currency?

Yes. Add or edit a custom limit for that currency and enable the **All withdrawals will be passed through manual moderation** checkbox. This overrides the default limit behavior for that currency and sends every withdrawal in it for approval regardless of amount.

Note that this setting is configured independently for interface withdrawals and API withdrawals — if you want it to apply to both, enable it in each tab.

### Why does a withdrawal have the Pending status?

A withdrawal receives the **Pending** status when it is sent for manual moderation because a withdrawal limit was triggered.

To continue processing the withdrawal, an Owner must open the transaction in the merchant dashboard and either approve or decline it.