POST
/
api
/
v1
/
transactions
/
wallet
/
mobile-money-deposit
Mobile Money Deposit
curl --request POST \
  --url https://hpay-api.host-sl.com/api/v1/transactions/wallet/mobile-money-deposit \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "wallet_id": "<string>",
  "amount": 123
}
'
{
  "transaction_id": "trans_123abc...",
  "payment_code": {
    "status": "success",
    "result": {
      "id": "monime_code_123",
      "code": "123456",
      "amount": 1050,
      "currency": "SLE",
      "instructions": "Dial *123# and enter code 123456"
    }
  },
  "transaction": {
    "id": "trans_123abc...",
    "wallet_id": "wall_789xyz...",
    "amount": 1000,
    "currency": "SLE",
    "status": "pending",
    "total_amount_paid": 10.5,
    "monime_fee": 0.3,
    "application_fee": 0.2
  }
}
This endpoint initiates a mobile money deposit to a user’s wallet via Monime. It generates a payment code that the user can use to complete the deposit through their mobile money provider (e.g., Orange Money, Africell Money).

​
Request Body

​
wallet_id
string
required
The unique identifier of the wallet to deposit funds into.
​
amount
integer
required
The amount to deposit in SLE cents (e.g., 1000 for 10.00 SLE).

​
Response

​
transaction_id
string
The unique identifier for the transaction in HOST Pay.
​
payment_code
object
The full response from the Monime service, including the generated payment code and instructions.
​
transaction
object
The transaction record details.
{
  "transaction_id": "trans_123abc...",
  "payment_code": {
    "status": "success",
    "result": {
      "id": "monime_code_123",
      "code": "123456",
      "amount": 1050,
      "currency": "SLE",
      "instructions": "Dial *123# and enter code 123456"
    }
  },
  "transaction": {
    "id": "trans_123abc...",
    "wallet_id": "wall_789xyz...",
    "amount": 1000,
    "currency": "SLE",
    "status": "pending",
    "total_amount_paid": 10.5,
    "monime_fee": 0.3,
    "application_fee": 0.2
  }
}

curl --request POST \
  --url https://hpay-api.host-sl.com/api/v1/transactions/wallet/mobile-money-deposit \
  --header 'api-key: YOUR_API_KEY' \
  --header 'secret-key: YOUR_SECRET_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "wallet_id": "wall_789xyz...",
    "amount": 1000
  }'