Create a transfer

Create a transfer to one Mobile Money beneficiary.

Endpoint

POST /api/transferts/initialise

Requires X-API-Key authentication.

Request body

FieldTypeRequiredDescription
amountintegerYesAmount in XAF. Must be between 500 and 1,000,000 and be a multiple of 50.
namestringYesBeneficiary name.
phonestringYesBeneficiary phone number in international format.
service_mobile_codestringYesThe code_prefix returned by Get mobile services.
succesbooleanNoSandbox-only simulation flag.

Example request

curl -X POST <SANDBOX_API_URL>/transferts/initialise \
  -H 'X-API-Key: <your_sandbox_api_key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": 2000,
    "name": "John Doe",
    "phone": "+237690000000",
    "service_mobile_code": "MTN-CM"
  }'

For sandbox requests, optionally add "sandbox_status": "COMPLETE", "FAILED", or "TIMEOUT" to control the final simulated status. This field is ignored for production keys.

Response

{
  "transfert": {
    "type": "TRANSFERT",
    "data": {
      "amount": 2000,
      "transfer_status": "INIT",
      "currency": "XAF",
      "when_created": "2026-11-13T10:30:00.000Z",
      "reference": "TEST-TXN-1731493800000-123456"
    }
  }
}

The transfer is recorded first and then processed asynchronously. An initial INIT status means that the transfer has been accepted for processing; it does not mean that the money has already been delivered. Save the returned reference to reconcile the transfer with your own order or payment record.

Errors

  • 400 — invalid or missing request field;
  • 401 — missing or invalid API key;
  • 404 — organisation, balance, or mobile service unavailable;
  • 500 — unexpected server error.