Stores
Read store identity, branding and accepted-origin settings.
On this page
List stores
/v1/profiles/{profileId}/storesAuthentication: Bearer key · Required scope: stores.read
No query parameters or body. Send Authorization: Bearer with your server key. Returns 200 with {stores: […]}, first-created store first. A store-scoped key sees only its store.
| Field | Details |
|---|---|
profileIdpath · required UUID | The profile that owns your API key. |
Store response
Manage stores in the app. A secret API key has stores.read only and cannot create or edit stores.
Stores in one merchant profile share the profile wallet. They do not provide seller-specific settlement.
| Field | Details |
|---|---|
storeId, nameUUID, string | Public project identity and display name. The ID does not authorize access. |
defaultExpiresIninteger | Default checkout lifetime in seconds. |
allowedOriginsstring[] | Exact origins allowed to embed checkout and receive approved returns. |
tokensOff{chainId, token}[] | Enabled assets this store does not accept. |
brandColor, logoAtstring | null | Store branding and logo timestamp. |
updatedAttimestamp | Last change in RFC 3339 format. |
Errors
Responses use {error: {code, message}}. Missing or invalid credentials return 401; missing scope or a different profile returns 403. Objects outside the caller’s store or mode are hidden with 404.
Invalid values return 422 invalid_value. Rate limiting returns 429 rate_limited with Retry-After. A starting network can return 503 network_not_ready; an unexpected server error returns 500 internal.