API Reference
API Overview and Architecture
Base URLs All API requests use HTTPS. There are two environments: Environment Base URL Purpose Sandbox https://sandbox-api.aelix.digitalapi.ai Development and...
Documentation
Find tutorials, API references, SDK guides, and integration walkthroughs.
Quick access
API Reference
Authentication Reference
Supported Authentication Methods 1. API Key (Simple) Suitable for server-side applications making read-only requests. Pass the key in the Authorization header:...
API Reference
Error Codes Reference
Error Response Format { "error": { "code": "string", "message": "Human-readable description", "trace_id": "trc_abc123", "details": [ { "field": "amount",...
SDKs & Tools
SDK Quickstart — JavaScript
Installation npm install @aelix/api-sdk # or yarn add @aelix/api-sdk Initialise the Client import { AelixClient } from '@aelix/api-sdk'; const client = new...
SDKs & Tools
SDK Quickstart — Python
Installation pip install aelix-sdk # Requires Python 3.9+ Initialise the Client import os from aelix import AelixClient client = AelixClient(...
API Reference
Webhook Event Reference
Event Delivery Guarantees At-least-once delivery — Aelix may deliver the same event more than once. Your handler must be idempotent Ordering — Events are...
Troubleshooting
Troubleshooting Common Integration Issues
Problem: 401 Unauthorized on Every Request Most common causes: Token expired — Access tokens expire after 3,600 seconds. Implement token refresh logic Wrong...
API Reference
API Changelog
2025-04-01 — API Version 2025-04-01 New Added GET /v1/transactions/export for bulk CSV export of transaction history Added POST /v1/payments/batch for...
Tutorials
Going Live Checklist
Before You Go Live Going live with your Aelix integration is straightforward, but completing this checklist will prevent the most common production issues. ✅...