API keys and rate limits
Create an API key on the Scale plan, authenticate with a bearer token, and stay inside 100 requests per minute per key.
Creating a key
Create keys in Settings. A live key begins ep_live_ and a test key ep_test_. Only a hash of the key is stored, so the full value is shown once, at creation, and cannot be recovered afterwards — listings show only the prefix and the last four characters. If you lose it, revoke it and make another.
Using a key
Authorization: Bearer ep_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxSee the API reference for the endpoints themselves.
Rate limits
Each key is allowed 100 requests per minute. Going over returns HTTP 429 with a Retry-After header telling you how long to wait. Errors come back in a consistent shape with a machine-readable code alongside the message, so you can branch on the code rather than parsing prose.
Still stuck?
Email support@embpay.com. It is the same address on every plan — there is no priority queue to be prioritised over. If something on this page disagrees with what the product does, that is a bug in this page and we want to hear about it.
Related
- Receiving webhooks and verifying signaturesReceive seven order and subscription events at your own https endpoint, verify the signature, and understand the retry schedule.
- Verifying a licence from your softwareCall one public endpoint to check whether a licence key is valid, with no API key needed and browser requests allowed.
- Which currencies you can sell inThe product form offers five currencies and the API accepts any Stripe-supported code. Prices are never converted automatically based on where your buyer is.