> For the complete documentation index, see [llms.txt](https://docs.iyzico.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iyzico.com/en/getting-started/preliminaries/limiters.md).

# Limiters

***

From a fintech perspective, iyzico's request limits play a crucial role in protecting the security, reliability, and stability of financial services delivered through HTTP-based APIs.

{% hint style="info" %}
If you exceed the limit, you will receive the following response. 
{% endhint %}

```json
{
  "status": "failure",
  "errorCode": 50000,
  "errorMessage": "Request Limit Exceeded",
  "locale": "en"
}
```

### Refund and Cancel Services Limits

| Service                | Method | Endpoint                                | Limit | Period |
| ---------------------- | ------ | --------------------------------------- | ----- | ------ |
| Refund                 | `POST` | /payment/refund                         | 400   | Minute |
| Refund V2              | `POST` | /v2/payment/refund                      | 150   | Minute |
| Cancel                 | `POST` | /payment/cancel                         | 150   | Minute |
| Merchant-Funded Refund | `POST` | /payment/iyzipos/refund/merchant/charge | 150   | Minute |

### Blacklist Services Limits

| Service               | Method | Endpoint                             | Limit | Period |
| --------------------- | ------ | ------------------------------------ | ----- | ------ |
| Add to Blacklist      | `POST` | /cardstorage/blacklist/card          | 80    | Minute |
| Remove from Blacklist | `POST` | /cardstorage/blacklist/card/inactive | 80    | Minute |
| Retrieve Blacklist    | `POST` | /cardstorage/blacklist/card/retrieve | 80    | Minute |

### Checkout Form Services Limits

| Service                  | Method | Endpoint                                           | Limit | Period |
| ------------------------ | ------ | -------------------------------------------------- | ----- | ------ |
| Initialize Checkout Form | `POST` | /payment/iyzipos/checkoutform/initialize/auth/ecom | 8000  | Minute |
| Retrieve Checkout Form   | `POST` | /payment/iyzipos/checkoutform/auth/ecom/detail     | 1000  | Minute |

### Loyalty Services Limits

| Service         | Method | Endpoint                 | Limit | Period |
| --------------- | ------ | ------------------------ | ----- | ------ |
| Loyalty Inquiry | `POST` | /payment/loyalty/inquire | 150   | Minute |

### Card Storage Services Limits

| Service               | Method   | Endpoint           | Limit | Period |
| --------------------- | -------- | ------------------ | ----- | ------ |
| Store Card            | `POST`   | /cardstorage/card  | 150   | Minute |
| Delete Stored Card    | `DELETE` | /cardstorage/card  | 30    | Minute |
| Retrieve Stored Cards | `POST`   | /cardstorage/cards | 200   | Minute |

### BKM Services Limits

| Service                | Method | Endpoint                 | Limit | Period |
| ---------------------- | ------ | ------------------------ | ----- | ------ |
| Initialize BKM Payment | `POST` | /payment/bkm/initialize  | 150   | Minute |
| Retrieve BKM Payment   | `POST` | /payment/bkm/auth/detail | 150   | Minute |

### Pre-Authorization Services Limits

| Service                                    | Method | Endpoint                                              | Limit | Period |
| ------------------------------------------ | ------ | ----------------------------------------------------- | ----- | ------ |
| Initialize Non-3DS Pre-Authorization       | `POST` | /payment/preauth                                      | 8000  | Minute |
| Initialize 3DS Pre-Authorization           | `POST` | /payment/3dsecure/initialize/preauth                  | 8000  | Minute |
| Initialize Checkout Form Pre-Authorization | `POST` | /payment/iyzipos/checkoutform/initialize/preauth/ecom | 8000  | Minute |
| Post-Authorization (Capture)               | `POST` | /payment/postauth                                     | 8000  | Minute |

### Other Services Limits

| Service                                    | Method | Endpoint                                              | Limit | Period |
| ------------------------------------------ | ------ | ----------------------------------------------------- | ----- | ------ |
| BIN Check                                  | `POST` | /payment/bin/check                                    | 50    | Minute |
| Initialize 3DS Pre-Authorization           | `POST` | /payment/3dsecure/initialize/preauth                  | 8000  | Minute |
| Initialize Checkout Form Pre-Authorization | `POST` | /payment/iyzipos/checkoutform/initialize/preauth/ecom | 8000  | Minute |
| Post-Authorization (Capture)               | `POST` | /payment/postauth                                     | 8000  | Minute |

### Marketplace Services Limits

| Service               | Method | Endpoint                         | Limit | Period |
| --------------------- | ------ | -------------------------------- | ----- | ------ |
| Approve               | `POST` | /payment/iyzipos/item/approve    | 1000  | Minute |
| Disapprove            | `POST` | /payment/iyzipos/item/disapprove | 100   | Minute |
| Create Sub-Merchant   | `POST` | /onboarding/submerchant          | 100   | Minute |
| Update Sub-Merchant   | `PUT`  | /onboarding/submerchant          | 100   | Minute |
| Retrieve Sub-Merchant | `POST` | /onboarding/submerchant/detail   | 100   | Minute |

### Reporting Services Limits

| Service                    | Method | Endpoint                                  | Limit | Period |
| -------------------------- | ------ | ----------------------------------------- | ----- | ------ |
| Transaction Details Report | `GET`  | /v2/reporting/payment/details             | 100   | Minute |
| Daily Transactions Report  | `GET`  | /v2/reporting/payment/transactions        | 75    | Minute |
| Scroll Transactions        | `GET`  | /v2/reporting/payment/scroll-transactions | 75    | Minute |

### Subscription Services Limits

| Service                    | Method | Endpoint                                                           | Limit | Period |
| -------------------------- | ------ | ------------------------------------------------------------------ | ----- | ------ |
| Transaction Details Report | `GET`  | /api/v2/subscription/orders/{subscriptionOrderReferenceCode}       | 100   | Minute |
| Daily Transactions Report  | `GET`  | /api/v2/subscription/products/{productReferenceCode}/pricing-plans | 100   | Minute |
| Scroll Transactions        | `GET`  | /api/v2/subscription/pricing-plans/{pricingPlanReferenceCode}      | 200   | Minute |
|                            |        | /api/v2/subscription/subscriptions                                 | 100   | Minute |
|                            |        | /api/v2/subscription/subscriptions/{subscriptionReferenceCode}     | 500   | Minute |
|                            |        | /api/v2/subscription/subscriptions//retrieve-subscription-url      | 100   | Minute |
|                            |        | /api/v2/subscription/checkoutform/{checkoutFormToken}              | 500   | Minute |
| Create Product             | `POST` | /api/v2/subscription/products                                      | 100   | Minute |
| Update Product             | `POST` | /api/v2/subscription/products/{productReferenceCode}               | 100   | Minute |