Get started

Authentication and keys

Send your secret key in the Authorization header of every request.

curl https://api.paygenthq.ai/v1/business -H "Authorization: Bearer sk_test_…"
  • Secret keys (sk_test_, sk_live_) are for your server only. Never put one in a web page or an app.
  • A secret key is shown once, when you make it. Lost it? Make a new one and delete the old one.
  • Owners, admins and developers can make keys; each needs a fresh authenticator code.
  • IP allowlist (Settings › Developers › Security): one list for live keys and one for test keys. Once a list has addresses (single addresses or ranges like 102.89.4.0/24), that mode's secret keys get 403 ip_not_allowed from anywhere else. An empty list lets them work from any address.
  • Every request is listed on the API logs page, with secrets and personal details removed.

Bodies can be JSON (Content-Type: application/json) or form fields (curl -d).