Skip to main content
POST
/
api
/
v1
/
testing
/
simulate-monime-webhook
curl --request POST \
  --url https://hpay-api.host-sl.com/api/v1/testing/simulate-monime-webhook \
  --header 'api-key: YOUR_API_KEY' \
  --header 'secret-key: YOUR_SECRET_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "transaction_id": "b1f2c3d4-...",
    "status": "successful"
  }'

{
  "message": "Webhook simulation processed",
  "transaction_id": "b1f2c3d4-...",
  "status": "completed"
}
Simulates the Monime provider webhook so a pending Test Mode deposit completes (or fails) without a real mobile-money payment. This is how you drive the deposit lifecycle end-to-end in the sandbox — see the testing guide.
Test Mode only. Calling this with Live Mode credentials returns 403.

​
Request Body

​
transaction_id
string
required
The ID of the pending deposit transaction to complete or fail.
​
status
string
default:"successful"
The outcome to simulate: successful or failed.

​
Response

{
  "message": "Webhook simulation processed",
  "transaction_id": "b1f2c3d4-...",
  "status": "completed"
}

curl --request POST \
  --url https://hpay-api.host-sl.com/api/v1/testing/simulate-monime-webhook \
  --header 'api-key: YOUR_API_KEY' \
  --header 'secret-key: YOUR_SECRET_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "transaction_id": "b1f2c3d4-...",
    "status": "successful"
  }'