This section describes the classic integration with the Adyen payments platform. To know more about a newer integration, refer to the Checkout documentation instead.
Local payment methods
If you want to learn how to accept local payment methods, see Directory Lookup.
When you want to reduce your PCI compliance requirements, we recommend that you integrate with our Client-Side Encryption library instead.
Before you begin
- Create a test account as described in the Getting started tutorial.
- Get your API key or basic authentication credentials. Save a copy as you'll need it for API calls you make to the Adyen payments platform.
Your card payments go through many stages. The diagram below helps you understand the flow:
If you are integrating the Adyen payments platform of products and services with a third-party system, we strongly recommend you follow defensive programming best practices.
To test the payment request, use one of our test credit cards.
In this request, include
reference, and the payment
amount. The amount's value is in minor units, e.g. 20000 is 200 euros. You can find the number of decimal points per currency in Currency codes.
In addition, include card information, as shown in the example below.
To know more about the required fields see PaymentRequest.
If the message passes validation, the system performs a risk analysis. Depending on the outcome, the system attempts an authorisation and you receive a payment response. The response includes a PSP reference, which uniquely identifies each payment and can be used later for cancel/refund if needed.
For other possible response codes and fields of the payment response, refer to PaymentResult.
Capture a payment
Capture approved authorisation when it is necessary to complete the payment.
Set up notifications
Receive confirmation when a payment is authorised or fails.