Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.iterapay.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to generate a new API key for a merchant. API keys allow your server-side code to authenticate requests without a user session, making them suitable for automated integrations and backend services.
Generating a new key immediately invalidates the merchant’s previous API key. Any services or integrations using the old key will stop authenticating. Update your credentials before rotating keys in production.
This endpoint requires Bearer token authentication. API key authentication is not accepted here, as this endpoint manages the API keys themselves.

​
Path parameters

​
merchantID
string
required
The UUID of the merchant for which to generate an API key.

​
Response

Returns a 200 OK with the newly generated API key on success. Store this value securely — it is only returned once and cannot be retrieved again.
​
key
string
The full API key string. Use this value in the X-Api-Key header for subsequent requests. The key is prefixed with iterapay_live_ to indicate its environment.
curl --request POST \
  --url https://api.iterapay.com/key/generate/b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f \
  --header 'Authorization: Bearer <token>'

{
  "key": "iterapay_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
}