FAQ — Transfers & Payouts

General

Is there a bulk/batch transfer option?

Not currently — there is no CSV or batch payout endpoint. Every transfer is created individually via POST /transfers, one beneficiary at a time.

How long does a Mobile Money transfer take?

In production, the majority of Mobile Money transfers are completed in under 2 minutes. The delay depends on the recipient operator and network load.

Is there a minimum or maximum amount per transfer?

Yes, the limits depend on your contract and the recipient operator. Check your Wajub Dashboard for your current caps.

Single transfers

How do I know if a transfer was completed?

As with payments, the source of truth is the transfer.succeeded webhook or explicit verification. The succeeded status means the recipient has received the funds.

Can I cancel a transfer?

There is currently no cancel/delete endpoint for transfers — once created, a transfer proceeds through pending → processing → a terminal status (succeeded, failed, or cancelled if the provider itself aborts it before completion).

What happens if the recipient's number is invalid?

The transfer moves to failed status with an invalid_recipient-style failure reason. A transfer.failed webhook is emitted. No funds are debited.

Do I need to top up my account before making transfers?

Yes. The balance held by our licensed partner must be sufficient to cover the transfer amount and any fees. Without sufficient balance, the transfer fails.