
New statuses for Payments made with Point Terminals
Payments made through Point terminals will now have two new payment statuses: “pending” and “cancelled”. This change will take effect starting May 5th in Brazil and soon in Argentina and Mexico. The “pending” status will indicate that the payment is awaiting confirmation from the Point terminal to determine whether it has been approved or rejected. If the payment is rejected, it will generate the new “cancelled” status, which, until now, was represented as a “refunded” status.
With these changes, the “refunded” status will be exclusively reserved for cases where the seller issues a refund for a payment; thus, this status should be maintained within the business logic.
Important: The “pending” status will remain in that condition until the device reports the payment status, either as “approved” or “cancelled”. If the terminal fails to report the payment status, it will automatically be considered “approved” after 4 hours.
What is the impact?
If you are using Point terminals linked to your Point of Sale (POS) and receive notifications about status changes from the Payments API, you will need to make the necessary modifications to include these new statuses: “pending” and “cancelled”. If you do not update your integration, your business logic will be affected, as not recognizing these statuses can result in errors, thereby creating a negative impact on your sales.
Our recommendation
Make the necessary changes as soon as possible. Additionally, we recommend that you configure webhook notifications for the “Point Integrations” topic instead of the Payments topic. Keep in mind that Integrated Payment is a feature designed to focus on payments from POS, which will provide you with a detailed level of the integration status. This reduces the consumption of generic-purpose APIs like Payments, which may have limitations when changes occur due to their focus on more general functionalities that may not guarantee backward compatibility.
Remember that if you have any questions or need assistance, you can contact our technical support.