Overview

The KiraPay API provides endpoints to generate and manage payment links. It’s designed to be simple, secure, and easy to integrate into your applications.

Base URL

All requests are made to:

https://kirapay-api.holatech.app/api

---

Authentication

Every request must include your API key in the headers:

x-api-key: YOUR_API_KEY
Content-Type: application/json

---

Error Handling

Error Response Format

All error responses follow this structure:

Example

{
  "statusCode": 400,
  "message": "ERROR_CODE",
  "timestamp": "2025-01-25T10:00:00.000Z",
  "path": "/request/path"
}

---

Common HTTP Status Codes

Code	Meaning	Description
200	OK	Request successful
201	Created	Resource created successfully
400	Bad Request	Invalid request parameters or body
401	Unauthorized	Missing or invalid x-api-key
404	Not Found	Requested resource does not exist
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Something went wrong on our side

---