Utopia Payments API
Accept one-time payments and renewing subscriptions from your own website.
Your server creates a checkout session and redirects the customer to its
checkout_url. They pay on Utopia's secure hosted page, then come back to your
return_url. A signed webhook tells your server the outcome, so you can
fulfil the order even if the customer closes the tab.
| Base URL | https://utopia-payments.com/api/v1 |
| Format | JSON over HTTPS |
| Amounts | Integer minor units: 34900 is AED 349.00 |
| Ids | Prefixed by type: pay_, cks_, sub_, pdt_, cus_ |
| Spec | OpenAPI 3.1 document |
How a payment works
- Your server calls
POST /checkout_sessionswith what the customer is buying. - You redirect the customer to the session's
checkout_url. - The customer pays on the hosted checkout and returns to your
return_url. - Utopia sends
payment.succeededto your webhook endpoint, and you fulfil the order.
Start here
Authentication
Create a secret key and make your first request.
One-time payments
Create a checkout session and fulfil orders from the webhook.
Subscriptions
Charge customers automatically every day, week, month or year.
Webhooks
Receive signed events and verify every delivery.
Customers
Create customer records and understand payment-time matching.
Libraries
Node.js, PHP and a WooCommerce plugin.
API reference
Every endpoint, parameter and response, with a request builder.