Rejection Notifications
Receive real-time information about your customers' rejected transactions.
Introduction
This functionality will allow you to receive real-time rejection notifications via webhook of transactions rejected by Pomelo and notify your customers so they can retry the operation.
For example, if a customer enters the card's CVV incorrectly, you could send them a message that takes them to the details of their virtual card.
Events
These are the events that we will notify you via webhook:
| EVENT | STATUS DETAIL |
|---|---|
| Stand-In Brand (120) | OTHER |
| Restricted User | RESTRICTED_USER |
| Invalid messaging format | MISSING_FIELDS |
| Invalid PIN | INVALID_PIN |
| Invalid CVV | INVALID_CVV |
| Invalid expiration date | INVALID_EXPIRATION_DATE |
| Invalid amount | INVALID_AMOUNT |
| Invalid transaction | INVALID_TRANSACTION |
| Transaction not permitted | TRANSACTION_NOT_PERMITTED |
| Suspected fraud | REJECTED_FRAUD |
| Exceeded the card PIN tries | PIN_TRY_LIMIT_EXCEED |
| Timeout | CLIENT_TIMEOUT |
| Client not available | CLIENT_UNAVAILABLE |
| Internal Pomelo error | INTERNAL_ERROR |
| Non-existent card | CARD_NOT_FOUND |
| Card not configured | CARD_NOT_CONFIGURED |
| Disabled Card | CARD_DISABLED |
| Inactive card | CARD_NOT_ACTIVE |
Implementation
Find out how to configure your rejection webhooks in this article.
Merchant advice code
This functionality is designed to provide acquirers and merchants with information so they do not make multiple retries to process an operation, saving costs of failed transactions. In addition, by obtaining this data in real time, they can contact users to offer them a solution to complete the operation successfully. 😉
Use cases
| Insufficient funds | We ask the acquirers to try again later. If we inform the customer that the operation failed due to lack of funds, they could deposit money and the next attempt would be successful. |
| Expired card | We inform the acquirers not to try processing the transaction again and to obtain the new card details. |
| Card paused or disabled | We inform the acquirers not to try processing the transaction again as the card is not enabled. |
FAQs:
What types of notifications do we send?
We only send rejection notifications. That is, all notifications with the status REJECTED.
Are retries made for these webhooks?
Yes. If your response is different from HTTP Status 200, the notification is re-enqueued and retried every 10 minutes for the next 4 days.