Initiate RefundThis API enables you process refund to a customer for a transaction.
Endpoint
| Info | ||
|---|---|---|
| ||
GET: https://sandbox.monnify.com/api/v1/transactions/initiate-refund |
Please note that this endpoint is protected using OAuth2 Token. Visit Authentication section of this document for details on OAuth2 Token.
...
| Field | Description | |
transactionReference | Unique identifier for the transaction generated by Monnify. | Yes |
refundAmount | Amount to refund. Minimum value is N10, and maximum is total transaction amount. If not specified, total transaction amount will be refunded. | No. Defaults to transactionAmount. |
| refundReason | A note describing reason why this transaction is being refunded. | Yes |
| customerNote | An optional note which will be serve as narration in credit to customer's bank account. | No |
| refundStatus | Status of the refund. Possible values are IN_PROGRESS, FAILED, COMPLETED. | |
| refundType | FULL_REFUND or PARTIAL_REFUND. FULL_REFUND is refund amount is total transaction amount. | |
| createdOn | The data/time refund was initiated. | |
| completedOn | Date and time refund was completed to customer. | |
| comment | Comment describing status of the refund. If FAILED, comment will contain the reason for the failure. |
...
| Response Code | Response Message |
0 | Request is received successfully and will be processed. |
R1 | Transaction with specified reference does not exist. |
| R2 | Refund not permitted for specified transaction. |
| R3 | Specified refund amount is above transaction amount. |
| R4 | Specified refund amount is below minimum refund amount. |
| R5 | Merchant does not have sufficient funds to process refund. |
Price
Refund on payments via account transfer costs N10 per refund.