Skip to content

FAQ

Getting Started

How do I create a Djamo Business account and get API access?

To get started, follow the Onboarding guide. Once your account is reviewed and approved, you'll receive your API credentials to begin your integration.

Is there a sandbox environment available for testing?

Yes. Djamo provides a dedicated test environment so you can develop and validate your integration safely, without processing real transactions. See the Basics section for setup instructions.

Payments (Collection)

Will my customers be able to pay via mobile money?

Not currently, the Djamo Business API supports Djamo-to-Djamo payments only.

What is the maximum amount I can receive?

The receiving limit is 200,000,000 FCFA. For limits specific to your account, reach out via the Contact page.

How do I know when a payment has been successfully completed?

Djamo sends real-time event notifications via webhooks to your configured endpoint on the charge/events topic. See the Events section for available events and payload details.

How do I know if a payment has failed or expired?

Payments that aren't completed within 1 hour are automatically marked as dropped, and a webhook is sent on the charge/events topic. You can also poll GET /v1/charges/:id and check that the status field is dropped. See Retrieve a charge.

Note

The full charge lifecycle — including all statuses and TTL — is covered in the Collection API docs.

How do I test payments on staging?

On staging, you cannot use the Djamo app to pay a charge. Instead, use the pay endpoint to simulate payments with test phone numbers. See the Pay a charge (Staging) section.

Transfers

Are there limits on transfer amounts?

The maximum transfer amount is 200,000,000 FCFA. For limits specific to your account, reach out via the Contact page.

How are transfer status updates delivered?

Transfer lifecycle events are pushed to your endpoint via webhooks. You'll receive notifications across three stages: transactions/started, transactions/completed, and transactions/failed. See the Events section for full event details and payload formats.

Webhooks

How do I troubleshoot webhooks not being received?

  1. Check your webhook configuration. Make sure you have subscribed to charge/events for payment collection, and to transactions/started, transactions/completed, and transactions/failed for transfers.
  2. Verify your endpoint is publicly reachable. Djamo must be able to reach your server over the internet, localhost URLs will not work.
  3. Check your server logs. Confirm your endpoint is receiving the request and returning an HTTP 200 response. A non-200 response may cause retries or missed events.
  4. Check your webhook signature verification. A misconfigured secret will cause events to be rejected on your end.
  5. Contact support if the issue persists.