FX And Conversion API

All conversions use quotes with expiry, visible rates, and explicit acceptance. Hidden or stale rates are not permitted.

Endpoints

Endpoint Method Auth Headers Notes
Create FX quote
/payment/api/v1/fx/quotes/
Create a live fiat-to-fiat quote routed through the configured FX provider.
POST User JWT
Authenticated caller
Authorization: Bearer <user-jwt>
Content-Type: application/json
Sandbox: Supported with sandbox keys and adapters.
Production: Available subject to verification, country activation, and provider support.
Rate limits: Standard authenticated rate limits
Accept FX quote
/payment/api/v1/fx/quotes/{reference}/accept/
Execute a confirmed FX quote through the financial engine.
POST User JWT
Authenticated caller
Authorization: Bearer <user-jwt>
Content-Type: application/json
Webhooks: wallet.debited, wallet.credited
Sandbox: Supported with sandbox keys and adapters.
Production: Available subject to verification, country activation, and provider support.
Rate limits: Standard authenticated rate limits