Payer Verification

As a merchant, you are to provide a payer verification endpoint for monnify to call to verify customer or payer who wants to make payment at any of our Moniepoint agent location.

Message Method	Description
HTTP POST	Once you have provided payer verification endpoint, monnify will call the endpoint to verify any customer/payer who wants to make payment for any product or service.

Request Parameters

Field	Description
productCode	This is the product code for the product to be purchased.
paymentRecipientId	This is the ID specified by customer as gotten from merchant for the product

Sample Request

{
  "productCode": "P10101",
  "paymentRecipientId": "LAHRAY101"
}

Response Parameters

Field	Description
paymentRecipientId	This is the ID specified by customer as gotten from merchant for the product
paymentRecipientDescription	This is the name or description tied to the payment recipient ID to be returned by merchant

Sample Response

{
  "responseCode": "00",
  "responseMessage": "User details retrieved successfully.",
  "paymentRecipientId": "21220002312312",
  "paymentRecipientDescription": "DAMILARE OGUNNAIKE SAMUEL"
}

Sample Response (When user does not exist)

{
  "responseCode": "02",
  "responseMessage": "User does not exist."
}