Logo

Prana Connect

Prana ConnectAPI ReferencePayments

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

  • pending
  • succeeded
  • failed
  • expired
  • reversed

How is this guide?

Last updated on

On this page