FOR DEVELOPERS

Build on AELX Pay

A single REST API to settle payments on-chain. Full documentation, SDKs, sandbox environment, and webhook support.

Quick Start API Reference

QUICK START

Get started in 3 minutes.

Base URL

https://api.aelx-pay.aeltrix.to/v1

Authentication

All requests require a Bearer token. Use sk_test_... for sandbox and sk_live_... for production.

Authorization: Bearer sk_test_your_api_key

Content Type

Content-Type: application/json

Rate Limits

Test: 100 req/minProduction: 1,000 req/min

Create a Payment

curl -X POST https://api.aelx-pay.aeltrix.to/v1/payments \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000.00,
    "currency": "AED",
    "merchant_id": "merch_abc123",
    "description": "Invoice #2048",
    "webhook_url": "https://your-site.com/webhook"
  }'

Response — 200 OK1.8s

{
  "id": "pay_7f3a9b2c1d4e",
  "status": "confirmed",
  "amount": 1000.00,
  "currency": "AED",
  "fee": 5.50,
  "net_amount": 994.50,
  "settlement_tx": "0xab3f...c91d",
  "block_number": 42391,
  "settlement_time_ms": 1847,
  "created_at": "2026-04-01T14:30:00Z"
}

API REFERENCE

Endpoints

Method	Endpoint	Description
POST	/v1/payments	Create a new payment
GET	/v1/payments/:id	Retrieve payment status
GET	/v1/payments	List all payments
POST	/v1/merchants	Register a merchant
GET	/v1/merchants/:id	Get merchant details
GET	/v1/settlements	List settlements
GET	/v1/settlements/:id	Get settlement details
POST	/v1/webhooks	Register a webhook endpoint

WEBHOOKS

Real-time event notifications.

Register webhook endpoints to receive real-time notifications for payment and settlement events. All webhooks include HMAC signatures for verification.

payment.created

Fired when a new payment is initiated.

payment.confirmed

Fired when payment is confirmed on-chain.

settlement.completed

Fired when settlement reaches the merchant.

settlement.failed

Fired if settlement fails or is reverted.

SDKs

Official client libraries.

Use our official SDKs for type-safe API access with built-in error handling and retry logic.

Node.jsAvailable

PythonAvailable

GoComing Q3 2026

RustComing Q4 2026

Install via npm

npm install @aelx-pay/sdk

SANDBOX

Test before you ship.

Full test environment with test AELX tokens, simulated settlements, and webhook testing. No real funds required.

Get API Keys →Contact Developer Support