Retrieve your account
Returns the merchant this key belongs to: the business name and support email customers see, whether the key is a live or a test key (`livemode`), whether card payments are ready (`payments_enabled`), and the currencies new products and carts may be priced in. Call it to confirm a key works and which mode it is in, and read `currencies` before creating a product: a checkout in any other currency is refused with `CURRENCY_NOT_SUPPORTED`. While payments are unavailable the list is empty.
Returns the merchant this key belongs to: the business name and support email customers see, whether the key is a live or a test key (livemode), whether card payments are ready (payments_enabled), and the currencies new products and carts may be priced in. Call it to confirm a key works and which mode it is in, and read currencies before creating a product: a checkout in any other currency is refused with CURRENCY_NOT_SUPPORTED. While payments are unavailable the list is empty.
Authorization
secretKey Your secret key: sk_live_… or sk_test_….
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/account"{ "object": "account", "business_name": "string", "support_email": "user@example.com", "livemode": true, "payments_enabled": true, "subscriptions_enabled": true, "currencies": [ "USD" ]}List events GET
Lists the events recorded for the key's merchant and mode, newest first, whether or not an endpoint was listening when they happened. Filter by `type` to walk one kind. One page carries `items`, `has_more` and `next_cursor`; pass `next_cursor` back as `cursor` for the next page. Use it to catch up on what happened while your endpoint was down, and to reconcile your records against what Utopia sent.
payment.failed Webhook
A payment attempt was declined or failed. Sent to your endpoint as a signed POST. Answer with any 2xx within 10 seconds; a delivery that fails is retried after 5 seconds, 5 minutes, 30 minutes, and 2, 5, 10 and 10 hours — eight attempts in all, spanning a little more than a day. Verify the signature before trusting the body.