​
Element Pay API Reference

Welcome to the Element Pay API documentation. Our REST API enables seamless crypto-to-fiat and fiat-to-crypto transactions across multiple blockchain networks.
Base URL: https://staging.elementpay.net/api/v1Authentication: All endpoints require an x-api-key header

​
Quick Start

Create Your First Order

Start with onramp or offramp transactions

Check Order Status

Monitor transaction progress in real-time

Get Exchange Rates

Fetch current conversion rates

Webhook Integration

Receive real-time order updates

​
Authentication

All API requests require authentication using an API key in the request header: 
curl -H "x-api-key: YOUR_API_KEY_HERE" \
  https://staging.elementpay.net/api/v1/orders
Keep your API key secure and never expose it in client-side code. Store it as an environment variable.

​
Supported Networks & Tokens

​
Order Types

Onramp (Fiat → Crypto)

Convert fiat currency to cryptocurrency. Users pay via mobile money and receive crypto in their wallet.

Offramp (Crypto → Fiat)

Convert cryptocurrency to fiat currency. Users send crypto and receive fiat via mobile money.

​
Rate Limiting

API requests are rate limited to 100 requests per minute per API key. Exceed this limit and you’ll receive a 429 Too Many Requests response.

​
Error Handling

The API uses conventional HTTP response codes:
  • 200 - Success
  • 400 - Bad Request (invalid parameters)
  • 401 - Unauthorized (invalid API key)
  • 404 - Not Found
  • 429 - Too Many Requests
  • 500 - Internal Server Error
All error responses include a descriptive message: 
{
  "status": "error",
  "message": "Invalid API key provided",
  "code": "INVALID_API_KEY"
}

​
Need Help?

Email Support

Get technical support

WhatsApp Community

Join our developer community

Quickstart Guide

Get started in minutes