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.

...

Response CodeResponse Message

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.
R6

Customer account details are invalid.

N.B. To resolve this error: Every payment made by customers contains the sender's account details, and that is where refunds are sent to. However, on rare occasions, the sender's account details aren't sent to Monnify. To handle this scenario, include the customer's valid destinationAccountNumber and destinationAccountBankCode in your request body

R7

No refund was initiated with the supplied refund reference.  

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.

...