Skip to main content
POST
Initiate Refund/Reversal

Overview

Use this endpoint to initiate a refund or reversal for a collection payment. The request is asynchronous: you receive a request_uuid immediately, then check the final outcome via the status endpoint.
Auth: Requires a Collection token (Authorization: Bearer <collection_token>).

Endpoint


Request body


Example request


Example response (accepted)


Next step

Use the request_uuid to check the final outcome: Refund/Reversal status.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
transaction_reference
string
required

Original transaction reference to refund/reverse.

payment_uuid
string
required

Original Waftpay payment UUID.

amount
number
required

Amount to refund/reverse in major units.

notification_url
string<uri>
required

HTTPS URL to receive final status callbacks.

remarks
string

Optional reason or notes.

Response

Accepted

code
integer
required

Application code, e.g., 102 for SUCCESS.

status
string
required

Semantic status, e.g., SUCCESS.

description
string
required

Human-readable description.

results
object
required

Request metadata for status checks.