Payer Verification
- Emmanuel Okorie
- Benjamin Ononogbu
- Damilare Ogunnaike
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 |
amount | this is the expected amount to be paid. |
Sample Response
{
"responseCode": "00",
"responseMessage": "User details retrieved successfully.",
"paymentRecipientId": "21220002312312",
"paymentRecipientDescription": "DAMILARE OGUNNAIKE SAMUEL"
}
Sample Response(MERCHANT_INVOICE)
{
"responseCode": "00",
"amount": 2000
"responseMessage": "User details retrieved successfully.",
"paymentRecipientId": "21220002312312",
"paymentRecipientDescription": "DAMILARE OGUNNAIKE SAMUEL"
}For a product type of MERCHANT_INVOICE, the amount field in the response is a mandatory parameter.