v1

latestOpenAPI 3.1.02026-07-26590236.8 KB

Initiate Deposit

post/deposit

Request body

type'mobile_money' required

currency'GHS' | 'KES' | 'EGP' | 'XAF' | 'XOF' | 'ZAR' | 'TZS' required

amountinteger required

descriptionstring required

Response

200

statusstring

messagestring

Example response

{
  "status": "success",
  "message": "Deposit initiated successfully",
  "data": {
    "id": "dep_2f6f8f3b-7e58-4f57-b0a9-6f3a0a9c8e2d",
    "object_type": "deposit",
    "type": "mobile_money",
    "rail": "mobile_money",
    "currency": "GHS",
    "currency_source": "GHS",
    "amount": 50000,
    "amount_source": 50000,
    "settlement_type": "fixed",
    "settlement_rate": 1,
    "payer": {
      "mobile": "+233501234567",
      "auth_model": "OTP"
    },
    "status": "pending",
    "created_at": "2026-04-02T10:45:12Z"
  }
}