Conventions
Authentication
Authorization: Bearer ur_test_..., from your server only.Idempotency
An
Idempotency-Key makes money-moving requests safe to retry. Required to create a funding
intent.Errors
One envelope, a stable
code, a requestId and a retryable flag.Pagination
Newest first, with
limit and a next_cursor.Data
- Amounts are decimal strings such as
"25.0000000", never floats, and always travel with their asset. - Assets are ids such as
asset_usdc_stellar. See Assets and networks. - Ids are prefixed by type:
fi_funding intents,qt_quotes,pay_payments,stl_settlements,ref_refunds,evt_events,whep_webhook endpoints. - Timestamps are ISO 8601 in UTC.
Checkout endpoints
The three endpoints under/v1/public/funding-intents/{token} power the checkout. They take no
API key: the funding token is the credential, and they answer any origin so a browser can call
them directly. Use them to build a custom checkout.
OpenAPI
The API describes itself as OpenAPI 3.1 at/openapi.json on each base URL, for generating a
client in another language.