API reference
Every endpoint, parameter and response of the Utopia Payments API.
Each page is generated from the same OpenAPI 3.1 document the server uses, so it always matches the live API. You can also import that document into Postman, Insomnia or an SDK generator.
| Base URL | https://utopia-payments.com/api/v1 |
| Authentication | Authorization: Bearer sk_live_… or sk_test_… (details) |
| Amounts | Integers in minor units |
| Errors | { "code", "message" } with an HTTP status (codes) |
Every endpoint page has a request builder. Requests go straight from your browser to the live API with the key you enter, so use a test key.
Checkout sessions
Start a hosted checkout for a payment or a subscription.
Payments
Look up payments and their status.
Subscriptions
List, inspect and cancel subscriptions.
Products
One-time and recurring prices.
Webhooks
Manage endpoints and signing secrets.
Webhook events
The payload of every event Utopia sends.