Skip to main content

​
Adullam Payments Overview

Use the Payments API to collect money from your customers via mobile money (Orange, MTN, Moov, Wave) in West Africa. You can create a payment, retrieve a single payment, list payments with filters and pagination, and refund completed payments.

​
Core operations

Create Payment

Initiate a payment to charge a customer’s mobile money account (amount in XOF, channel required).

Get Payment

Retrieve a single payment by ID.

List Payments

List payments with optional filters: status, channel, customer_phone, amount range, date range, and pagination.

Refund Payment

Refund a completed payment (full or partial) with reason and optional description.

​
Payment flow

  1. Create a payment with amount (XOF), currency (XOF), customer_phone, and channel (orangeCI, mtnCI, moovCI, waveCI). Include Idempotency-Key header for safe retries.
  2. The customer approves the debit on their mobile. Status moves from pending to processing then completed or failed.
  3. Use List payments or Get payment to poll status, or rely on webhooks for event notifications.
  4. For completed payments, use Refund payment when needed (with idempotency key).

​
Support

Need help? Contact us by email (support@adullam.dev), WhatsApp (chat), or Telegram (@adullam_official).