TukuPay Docs

Reference

Rate limits

How much the gateway takes, and the headers that tell you.

LimitValueRefusal
Requests per app120 a minute unless TukuPay sets another; 60 for the first 30 days after you take an app live yourself429 rate_limited
Requests per MCP or CLI session60 a minute429 rate_limited
Requests per address1,200 a minute, before any key is checked429 rate_limited
Checking one payment's statusOnce every 30 seconds (a rule, not a refusal)
Payouts waiting for one account holder20 per app429 too_many_waiting
Payouts at onceOne per app and account409 payout_in_progress
Webhook test events and resends10 a minute per app429 too_many_manual
Amount per money callKES 250,000422 amount_invalid
Idempotency answers kept24 hours

Each signed answer carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (Unix seconds); a 429 also has Retry-After (seconds). Wait that long, then retry.