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.

If you exceed the limit, you will receive the following response.

{
  "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