1. Refund or cancel a payment request

post

https://beta-collect.paga.com/refund/v2

Refunds a paid payment request in full or in part, or cancels one that hasn’t been paid. Send one request per partial refund, each with its own referenceNumber. Reusing a referenceNumber returns status code 102 and never refunds twice.

Hash: referenceNumber + refundAmount + hashKey

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

referenceNumber

string

required

Defaults to RFD-2026-0031

Your unique reference for this refund. Hash value 1.

paymentRequestReference

string

required

Defaults to ORD-2026-0187

The referenceNumber of the original payment request.

refundAmount

number

required

Defaults to 1000

Amount to refund. Hash value 2.

currency

string

required

Defaults to NGN

reason

string

Defaults to Item out of stock

Headers

hash

string

required

^[0-9a-f]{128}$

Defaults to 3e0bfd015fdda6b999e83b5787df9a532e87fdd75f5a30b5f230683e58e07654a718bb4b341510a29d53406001f13275fb9ead88280cc0b7747cb97d3fe79705

SHA-512 of this operation’s hash fields, in order, followed by your hash key, as lowercase hex. See the code samples, or check your value with the Hash generator. Pre-filled with the hash of this step’s example values using the placeholder key YOUR_HASH_KEY, so it shows the right format. Replace it with the hash of your own values and your own hash key.

Response

200The refund request was processed. Look up statusCode in the Collect API status codes before acting.