Utopia PaymentsDocs

Authentication

Authenticate requests with a secret API key.

Create a secret key in Dashboard → Developers and send it as a bearer token. The key is shown once, so store it in your server's environment variables.

curl https://utopia-payments.com/api/v1/account \
  -H "Authorization: Bearer $UTOPIA_API_KEY"

Secret keys can take payments and read your data. Never put one in a browser, a mobile app or a public repository.

Live and test keys

Keys start with sk_live_ or sk_test_. Each kind has its own payments, subscriptions, webhooks and events; products and customers are shared. See Test mode.

Account approval and revoking

Your merchant account must be approved before keys can be used. Revoke a key from the dashboard at any time; requests using it stop immediately with 401 UNAUTHORIZED.

On this page