API Reference

REST API endpoints powered by Hyperswitch. All requests return JSON. Base URL: http://localhost:8081

GET/payments

List all payments with pagination.

Name	Type	Description
limit	integer	Max results (default 20, max 100)
starting_after	string	Payment ID to start after

GET/payments/{id}

Retrieve a single payment by ID.

POST/payments

Create a new payment intent.

Name	Type	Description
amount	integer	Amount in smallest currency unit (e.g. kobo)
currency	string	NGN, USD, GHS, ZAR, or KES
confirm	boolean	Confirm immediately
payment_method	string	card, bank_transfer, ussd, mobile_money

POST/payments/{id}/refund

Refund a completed payment.

Name	Type	Description
amount	integer	Partial refund amount (optional, defaults to full)

GET/customers

List all customers.

Name	Type	Description
limit	integer	Max results (default 20)
starting_after	string	Customer ID to start after

POST/customers

Create a new customer.

GET/customers/{id}

Retrieve a single customer.

GET/health

Health check endpoint.