Versions Compared

Key

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

This API can be used to get the status of an initiated refund.

Endpoint

GET: https://sandbox.monnify.com
Info
titleEndpoint
Info

This endpoint is protected with OAuth 2.0 Bearer token. To find out more about authorization for Monnify endpoints, check Here

Endpoint URL: {{base_url}}/api/v1/refunds/{{

...

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

HTTP Method: GET

Info

The {{base_url}} for test is https://sandbox.monnify.com but when you go live, it changes to the live url

Supported Path Variable

Request



Field

Description

Compulsory

transactionReferenceUnique transaction reference generated by Monnify for each transaction

refundReference

Your unique refund reference supplied in the initiate refund request

Yes

Get Refund Status Response

Code Block
languagejs
themeRDark
titleGet Refund Status Response
json
{
   "requestSuccessful":true,
   "responseMessage":"success",
   "responseCode":"0",
   "responseBody":{
 	     "transactionReferencerefundReference": "MNFY|0111231|123412342refundReference",
      "paymentReferencetransactionReference":"J_12312_122MNFY|0111231|123412342",
	      "transactionAmountrefundReason":5000, "Order      "refundAmount":1200was cancelled",
      "refundStatuscustomerNote":"IN_PROGRESS "Refund-orderJ111",
      "refundReasonrefundAmount":"Order was cancelled"1200,
      "customerNoterefundStatus":"Refund for order J1110IN_PROGRESS",
      "refundType":"FULL_REFUND",
      "createdOn":"1517/1203/20202021 093:3832:1309 AM",
      "completedOn":"1517/1203/20202021 124:2032:2309 PMAM",
      "comment":"Refund processed successfully."
   }
}

Response Codes

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

Response Code

Response Description

0

Request received. Please check refundStatus to confirm completion. 

R7

No refund has been initiated for supplied

transaction

refund reference.