CitaPay Developer API

Welcome to the CitaPay Developer Documentation. Our API is designed to be simple, predictable, and easy to integrate, allowing your application to accept payments and send payouts across multiple payment methods.

Base URLs

All API requests depend on the environment you are targeting.

Environment	Base URL
Production	`https://citapayapi.citatech.cloud/api/v1`
Sandbox	`https://sandbox.citapayapi.citatech.cloud/api/v1`

Always use the Sandbox environment for development and testing. It runs the same code as production, routing payment provider calls through real sandbox APIs (Daraja Sandbox for M-Pesa). Test transactions wait for real provider callbacks just like production — if you cancel an STK push, the transaction will fail. No real money moves.

Key Concepts

RESTful: Our API follows standard REST principles.
JSON: All request bodies and response payloads are formatted in JSON.
Secure: Strict authentication via Bearer tokens and signature verification for webhooks.
Async Processing: Payments are processed asynchronously; use Webhooks for real-time updates.
Multi-Provider: Choose your payment method via the paymentMethod field. M-Pesa and Card are live today; Bank Transfer is coming soon.

Supported Payment Methods

Value	Description	Status
`MPESA`	M-Pesa STK Push & B2C (Kenya)	✅ Live
`CARD`	Debit / Credit Card	🔲 Disabled - building native processor
`BANK_TRANSFER`	Direct bank transfer	🔲 Coming soon

Need Help?

If you encounter any issues, please contact our implementation team at support@pay.citatech.cloud.