This article gives recommendations on your first troubleshooting steps after facing issues with processing payments via PayPal (especially the PayFlow Pro solution).
Some recommendations in this article may seem obvious. Still, the Magento or PayPal Support Engineers will ask you to perform these steps anyway.
Most of the problems with PayPal payments have similar symptoms: after specifying the payment card details and proceeding to checkout, the payment is not being processed. Instead, there might be an error message, failure to process payment, or even a blank page.
Verify your credentials, crypt keys, and licenses
Possible problems: misprints in account details (usernames, passwords), invalid accounts, expired or non-specified licenses, invalid public and personal keys, and many other aspects. To find those problems, you might also need to check your payment configuration settings.
Apply consistent settings in Magento and PayPal
Make sure you have applied the same settings and have enabled the same functionalities in both Magento Admin and PayPal account settings.
For example: when applying the PayPal Express Checkout solution, transactions based on AVS/CSC responses must be declined in PayPal Manager (Service Settings > Set Up > Security Options) and in Magento Admin (Stores > Configuration > Sales > Payment methods...). For more info, see the documentation: PayPal, Magento.
Allow reference transactions
If your PayPal payment method involves API with Billing Agreements and Reference Transactions, make sure these are enabled and configured correctly in your settings.
When nothing helps: create a Support Ticket and collect advanced payment logs
To troubleshoot complicated payment issues, the Magento Support Team may ask you to apply a dedicated patch to enable advanced payment logging. In this case, your steps should be the following:
- submit a Support Ticket
- specify your issue with as many details as possible
- mention the steps from this article that you have performed and the results you have had
- request an Advanced Payment Logging patch (reference number MDVA-4352) and instructions on applying the patch
- apply the patch, collect logs, attached them to your Support Ticket
- wait for further recommendations from the Magento Support Team