NabooPay

Refunds

1 endpoint

Process full refunds for paid transactions. Refunds are sent instantly to the customer's original payment method (Wave or Orange Money).

Refunds are immediate and cannot be cancelled. The full transaction amount is always returned — partial refunds are not supported. The refund is sent to the customer's phone number used in the original transaction.

Requirements

  • Valid API key with scopes: checkout, write, read_and_write, or management
  • Transaction must exist and belong to your organization
  • Transaction must be in 'paid' or 'paid_and_blocked' status
  • Sufficient account balance to cover the refund amount
  • Transaction must not already be refunded or cancelled

Process Flow

  1. 1Validates the transaction exists and is refundable
  2. 2Checks account balance is sufficient
  3. 3Initiates refund with payment provider (Wave or Orange Money)
  4. 4On success: deducts amount from account, updates status to 'refunded'
  5. 5On failure: returns error without changing account balance
wave
orange_money
— supported payment methods

Refund a transaction

Processes a refund for a paid transaction, returning the full amount to the customer via their original payment method (Wave or Orange Money). The transaction must be in 'paid' or 'paid_and_blocked' status, your account must have sufficient balance, and the transaction must not already be refunded or cancelled. Refunds are processed immediately and cannot be cancelled. Partial refunds are not supported — the full transaction amount is always returned.

Path Parameters

ParameterTypeDescription
order_idpath
stringThe unique order ID of the transaction to refund.

Responses

200Refund processed — transaction status updated to 'refunded' and funds returned to customerRefundResponse
400Transaction not refundable (wrong status, insufficient balance, already refunded, or cancelled)
401Invalid or missing API key
403Forbidden — transaction belongs to another organization
404Transaction not found
429Rate limit exceeded (100 req / 60 s)
500Internal server error

Example Response

json
{
  "message": "Refund processed successfully"
}

Example Request

bash
curl -X GET "https://api.naboopay.com/api/v2/refund/ord_abc123def456" \
  -H "Authorization: Bearer YOUR_API_KEY"