API Documentation

API Reference

Integrate Wexon into your application with our simple REST API. Create cards, check status, and manage payments programmatically.

Overview

The Wexon API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON request bodies, returns JSON responses, and uses standard HTTP response codes.

Base URL: https://api.wexon.finance/v1

Authentication

The Wexon API uses API keys to authenticate requests. You can obtain your API key from the developer dashboard.

Authorization: Bearer YOUR_API_KEY

Endpoints

POST/cards/create

Create a new virtual card with specified parameters.

{
  "amount": 100,
  "currency": "USD",
  "payment_method": "SOL",
  "email": "user@example.com",
  "first_name": "John",
  "last_name": "Doe"
}

GET/cards/:id

Retrieve the status and details of a specific card.

{
  "id": "card_abc123",
  "status": "active",
  "card_number": "•••• •••• •••• 4242",
  "expiry": "12/28",
  "balance": 100.00,
  "currency": "USD"
}

GET/payments/:id

Check the status of a payment transaction.

{
  "id": "pay_xyz789",
  "status": "confirmed",
  "amount": 0.80645,
  "currency": "SOL",
  "usd_value": 100.00,
  "confirmed_at": "2025-01-15T10:30:00Z"
}

Webhooks

Configure webhooks to receive real-time notifications about card creation, payment confirmation, and other events.

Available Events

card.created - Fired when a new card is created
payment.pending - Payment initiated, awaiting confirmation
payment.confirmed - Payment confirmed on blockchain
card.activated - Card is ready for use

Rate Limits

The API is rate limited to ensure fair usage. Current limits are:

• 100 requests per minute for standard endpoints
• 10 card creation requests per minute
• Rate limit headers are included in all responses