Payments
Create, fetch, and confirm hospital payment intents
Create Payment
POST /v1/payments{
"amount": 1500,
"currency": "ETB",
"reference": "HOSP-INV-2026-000231",
"description": "Consultation fee",
"channel": "mobile-banking",
"customer": {
"name": "Patient Name",
"phone": "+251900000000"
}
}Example response:
{
"id": "pay_01J9Q9C2Z0T9N2",
"status": "pending",
"reference": "HOSP-INV-2026-000231",
"amount": 1500,
"currency": "ETB",
"channel": "mobile-banking",
"instructions": {
"type": "text",
"message": "Complete payment in Wegagen Bank mobile banking using reference HOSP-INV-2026-000231."
},
"createdAt": "2026-05-20T10:10:00.000Z"
}Get Payment
GET /v1/payments/{paymentId}Find by Reference
GET /v1/payments?reference={reference}Statuses
pendingsucceededfailedexpiredreversed
How is this guide?
Last updated on
