Initiate Refund/Reversal
Collections
Initiate Refund/Reversal
Create a refund or reversal request for a collection payment.
POST
Initiate Refund/Reversal
Overview
Use this endpoint to initiate a refund or reversal for a collection payment. The request is asynchronous: you receive arequest_uuid immediately, then check the final outcome via the status endpoint.
Auth: Requires a Collection token (Authorization: Bearer <collection_token>).
Endpoint
Request body
| Field | Type | Required | Notes |
|---|---|---|---|
transaction_reference | string | Yes | Original transaction reference to refund/reverse. |
payment_uuid | string | Yes | Original Waftpay payment UUID. |
amount | number | Yes | Amount to refund/reverse in major units. |
notification_url | string | Yes | HTTPS URL to receive the final status callback. |
remarks | string | No | Optional reason or notes. |
Example request
Example response (accepted)
Next step
Use therequest_uuid to check the final outcome: Refund/Reversal status.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Original transaction reference to refund/reverse.
Original Waftpay payment UUID.
Amount to refund/reverse in major units.
HTTPS URL to receive final status callbacks.
Optional reason or notes.
