This API version is deprecated

v1 is no longer maintained and will not receive new features or bug fixes. We strongly recommend migrating to v2, which offers better performance, richer filtering, pagination, and the new Payouts API.

v1 API

Deprecated

Base URL: https://api.naboopay.com/api/v1

Migration Guide

Replace v1 endpoints with their v2 equivalents. v2 uses RESTful path parameters instead of query parameters for IDs, lowercase payment method values, and a separate refund endpoint.

v1 Endpoint	v2 Equivalent	Notes
`POST /transaction/create-transaction`	`POST /api/v2/transactions`	Add required customer object; rename product.amount → price; drop category field; use lowercase payment methods
`DELETE /transaction/delete-transaction (pending)`	`DELETE /api/v2/transactions/{order_id}`	v2 DELETE only cancels pending transactions
`DELETE /transaction/delete-transaction (paid)`	`GET /api/v2/refund/{order_id}`	v1 auto-refunded paid transactions on DELETE; v2 requires a dedicated refund call
`GET /transaction/get-transactions`	`GET /api/v2/transactions`	—
`GET /transaction/get-one-transaction`	`GET /api/v2/transactions/{order_id}`	Use path param instead of ?order_id query param
`GET /account`	`GET /api/v2/accounts + GET /api/v2/accounts/stats + GET /api/v2/accounts/{id}`	—
`POST /cashout/wave`	`POST /api/v2/payouts`	Set selected_payment_method: wave; use recipient object instead of full_name + phone_number
`POST /cashout/orange-money`	`POST /api/v2/payouts`	Set selected_payment_method: orange_money; use recipient object instead of full_name + phone_number

Key Behavioral Differences

DELETE transaction splits into two operations in v2

In v1, DELETE /transaction/delete-transaction handled both cancellation and refund depending on the transaction status: pending transactions were cancelled, paid transactions were automatically refunded.

In v2 these are two separate endpoints: DELETE /api/v2/transactions/{order_id} only cancels pending transactions, while GET /api/v2/refund/{order_id} handles refunds for paid transactions. If your v1 integration used DELETE to refund paid transactions, you must add the refund call to your migration.

Payment method casing changed

v1 uses uppercase values (WAVE, ORANGE_MONEY, BANK). v2 uses lowercase (wave, orange_money, bank).

Product schema renamed fields

v1 products use amount and include a category field. v2 renames amount to price and removes category.

Error response field name changed

v1 errors return a Detail field (capital D). v2 errors return an error field (lowercase). Update any error-handling code that reads from the response body.

v1 error

json

{ "Detail": "Transaction not found" }

v2 error

json

{ "error": "Transaction not found" }

Transaction

4 endpoints

Create and manage payment transactions.

Account

1 endpoints

View your account balance and information.

Cashout

2 endpoints

Send money via Wave or Orange Money.