While integrating the Adyen platform of products and services with a third-party system, we strongly recommend you follow defensive programming best practices.
- This means, for example, that system-automated decisions should have defaulted to non-delivery of products and services:
- Your system should deliver products and services only after receiving an explicit authorisation response to a corresponding payment request.
- Your system should not deliver any products or services when it does not receive any explicit response.
Adyen - A valid Adyen merchant account.
PayPal - A valid PayPal and PayPal business test account.
Link your PayPal account(s) to your Adyen merchant account by sending our support the following details:
- The email address of your PayPal account to link it to your live Adyen account.
- (Optional) The email address of your PayPal Business sandbox test account to link it to your test Adyen account.
If your PayPal account allows it, shoppers can pay via bank transfer to PayPal. In this case, a payment authorisation notification takes about 5 to 7 business days before it is received.
Allowing bank transfers can result in never receiving refused payment notifications: when an order is initiated through the PayPal website, you need to accept it to if you want to process it and complete the transaction.
The funds are then released, and they are credited back to the shopper's PayPal account.
By default, PayPal accounts limit the refund time period to 180 days. However, longer refund periods may apply for certain accounts. When this is the case, the extended refund period needs to be configured accordingly in your Adyen merchant account as well: contact our support team to make sure the refund period in your Adyen merchant account reflects the one in your linked PayPal account. Refer PayPal documentation to know more.
By default, recurring payments are disabled in PayPal but can be enabled during the account setup. PayPal's online documentation provides clear descriptions and explanations about how to carry out this task:
- Subscriptions and Recurring Payments
- Payflow Recurring Billing Service User’s Guide
- Integrating Recurring Payments
PayPal express checkout shortcut
PayPal express checkout shortcut is an easier way for customers to submit a payment transaction by pre-filling billing and shipping details for them.
Ensure the following is set up for your merchant account before implementing the PayPal express checkout integration:
- Hosted Payment Pages integration.
- A result URL - A return URL corresponding to the order update or order review page, following a successful PayPal Express Checkout payment authorisation.
You can provide the URL as the
resultURL parameter value along with your HPP request when you initiate the payment, or you can define it in the skin configuration.
Supply the BrandCode ‘paypal_ecs’ and POST the form to the live.adyen.com/hpp/details.shtml endpoint.
PayPal express checkout needs to be configured on your account, send a request to Support Team and set it up. This is a separate configuration from the regular PayPal payment flow.