Payment Requery

As a merchant, you are expected to provide a payment requery end point

Message Method	Description

Message Method	Description
HTTP GET	Once you have provided the payment requery end point, monnify will call the end point to get the status of a payment request whose status is not known.

Query Parameters

Field	Description

Field

Description

transactionReference

This is the unique Monnify reference for the transaction.

This reference is sent as a urlEncoded string and should be decoded on the merchant’s end

Sample Request

{{merchantPaymentRequeryUrl}}?transactionReference=MNFY%7C44%7C20220407112123%7C000684

Response Parameters

Field	Description

Field	Description
responseCode	This is the response code for the transaction 00 - Successful 01 - Unsuccessful
productCode	This is the product code for the product to be purchased sent to merchant from the request.
paymentRecipientId	This is the payment recipient ID sent in the request
transactionReference	This is the unique Monnify reference for the transaction. This reference is sent as a urlEncoded string and should be decoded on the merchant’s end
paymentToken	This is the token to be returned by merchant that is required for the payment to be made.

Sample Response (Successful)

{
  "responseCode": "00",
  "productCode": "121221212",
  "paymentRecipientId":"{paymentRecipientId}}"
  "transactionReference":"MNFY|66|20210825115615|000002",
  "paymentToken": "{paymentToken}"
}

Response Parameters (Unsuccessful)

Field	Description

Field	Description
responseCode	This is the response code for the transaction
responseMessage	This describes the reason for the failed response

Sample Response (Unsuccessful)

{
  "responseCode": "01",
  "responseMessage": "Reason for failed response"
}