Vexutopia API Documentation
Vexutopia is a payment orchestration platform that lets you integrate multiple payment providers through a single, unified API. Process payments, manage customers, and handle webhooks with consistent interfaces across all providers.
Base URL
All API requests should be made to:
https://vexutopia.com/api/v1Authentication
The Vexutopia API uses API keys to authenticate requests. Include your API key in theX-API-Keyheader on every request.
Learn more in the Authentication guide.
Quick Start
Get up and running with Vexutopia in three simple steps:
Get your API key
Sign in to your dashboard and create a new API key. Use test keys for development and live keys for production.
Create your first payment
Make an authenticated POST to /v1/payments — this both verifies your key works and gives you a real session ID to play with:
curl -X POST https://vexutopia.com/api/v1/payments \
-H "X-API-Key: vex_test_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"amount": "20",
"currency": "USD",
"return_url": "https://yoursite.com/success"
}'The response body includes id (e.g. tx_…) and checkout_url. The customer goes to checkout_url to pay.
Retrieve a payment
Use the id returned in step 2 to look up the payment's current status:
# Replace tx_REPLACE_WITH_YOUR_ID with the id you got back in step 2.
curl https://vexutopia.com/api/v1/payments/tx_REPLACE_WITH_YOUR_ID \
-H "X-API-Key: vex_test_your_api_key"Browse documentation
Open a topic below for full request shapes, fields, and examples.
API reference
Create, retrieve, and manage payments
Render PIX, C2C, and SBP payments directly on your own site without our hosted checkout page.
All payment providers and rails available through Vexutopia's smart routing.
Receive real-time event notifications. HMAC signature verification + retry policy.
Accept Telegram Stars (XTR) inside Telegram bots and mini-apps. Settles in TON.
USD gift cards in fixed denominations. Pass gift_card_amount so checkout shows the matching face.
US customers pay a Lightning invoice from Cash App. Credited in invoice USD at 7%.