Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This API enables you process refund to a customer for a transaction.

...

Info
titleEndpoint
POST: https://sandbox.monnify.com/api/v1/refunds/initiate-refund

Please note that this endpoint is protected using OAuth2 Token. Visit Authentication  section of this document for details on OAuth2 Token.

...

When refund is initiated, the following response codes may be returned.

Response CodeResponse MessageAction

0

Request is received successfully and will be processed.


R1

Transaction with specified reference does not exist.


R2Refund not permitted for specified transaction.
R3Specified refund amount is above transaction amount.
R4Specified refund amount is below minimum refund amount.
R5Merchant does not have sufficient funds to process refund.
R6Customer account details are invalid.Include the customer's valid destinationAccountNumber and destinationAccountBankCode in your request body 
R7No refund was initiated with the supplied refund reference.Verify that the supplied refund reference is valid
R8supplied value has exceeded the maximum allowed number of characters.
R9Supplied refund reference already exists for the merchant.
R10Merchant account balance could not be retrieved.
R11Name inquiry network error.
R12The total amount of all refunds done on a particular transaction has exceeded the transaction amount.
M01System error. Contact support.
M02System error. Contact support.