Pay API

The Pay API lets your application accept payments from Elebne wallet users. There are two integration paths depending on how much control you need.

Choose your integration

How it works

1. Your server creates a payment intent via POST /dev/intents
2. The customer pays using their Elebne wallet (via hosted page, QR code, or 6-digit payment code)
3. Elebne sends a payment.confirmed webhook to your server
4. You verify the payment status via GET /dev/intents/{ref} and fulfill the order

Key concepts

• Payment intent -- represents a single payment request. Has a unique referenceNumber (e.g. PI-3XXXXXXXXXXXXXX) and a 6-digit code for in-person payments.
• Amounts in centimes -- all amounts are integers in centimes. 50000 = 500.00 MRU.
• Idempotency -- every write endpoint requires an X-Idempotency-Key header. Safe to retry on network errors.
• Sandbox mode -- test keys (sk_test_...) create sandbox intents with no real money. Use simulate-payment to test the full flow.

Base URL

https://api.elebne.ai/api/v1/dev

Authentication

All requests require a Bearer token with your API key:

Authorization: Bearer sk_test_YOUR_SECRET_KEY

Use secret keys (sk_test_, sk_live_) for creating intents, cancelling, and refunding. Publishable keys (pk_test_, pk_live_) can only read intent status.

Next steps

• Hosted Checkout -- redirect customers to Elebne's payment page
• Payment Intents -- full lifecycle: create, get, list, cancel
• Refunds -- full and partial refund flows
• Webhooks & Events -- real-time payment notifications