...
| Info |
|---|
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
| Code Block | ||
|---|---|---|
| ||
{
"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
| Code Block | ||
|---|---|---|
| ||
{
"responseCode": "00",
"responseMessage": "User details retrieved successfully.",
"paymentRecipientId": "21220002312312",
"paymentRecipientDescription": "DAMILARE OGUNNAIKE SAMUEL"
}
|
Sample Response(MERCHANT_INVOICE)
| Code Block |
|---|
{
"responseCode": "00",
"amount": 2000
"responseMessage": "User details retrieved successfully.",
"paymentRecipientId": "21220002312312",
"paymentRecipientDescription": "DAMILARE OGUNNAIKE SAMUEL"
} |
| Info |
|---|
For a product type of MERCHANT_INVOICE, the amount field in the response is a mandatory parameter. |
Sample Response (When user does not exist)
...