The refund object
A refund returns funds from a completed payment back to the customer’s wallet. Refunds are free — no platform fee is deducted.string
Unique identifier for the refund.
number
Refund amount in NGN.
string
Refund status. One of
COMPLETED or FAILED.string
Reason for the refund, if provided.
string
Destination address where the refund was sent.
string
On-chain transaction hash for the refund.
number
Time taken to execute the refund (in milliseconds).
number
Network gas fee for the transaction.
number
Actual USDC amount sent to the customer.
string
ID of the original transaction that was refunded.
string
ID of the refund’s own transaction record.
Transaction sub-object
When retrieving a Transaction withtype: "REFUND", the refund appears as a nested refund sub-object with these fields:
string
Unique identifier for the refund.
string
Reason for the refund, if provided.
string
Destination wallet address the refund was sent to.
string
ID of the original transaction being refunded.
string
On-chain transaction hash for the refund.
Create a refund
POST
Initiates a refund for a previously completed transaction. The full amount is returned to the specified wallet address.
/transactions/refundRequest body
string
required
Unique identifier of the original transaction to refund.
string
required
Destination wallet address for the refund. Must be a valid 66-character blockchain address.
string
Optional note explaining the reason for the refund.
Retry a failed refund
POST
Retries a previously failed refund.
/transactions/refund/retryRequest body
string
required
Unique identifier of the failed refund to retry.
