Search

Are you looking for test card numbers?

Would you like to contact support?

Online-payment icon

Integration checklist

Checklist for building an online payments integration with Adyen.

Follow the checklist below to ensure you have a complete implementation into Adyen.

Get a test account

Sign up to get a test account.

  1. Create a user login for yourself and your team members
    You will be given an admin user login for yourself when signing up. Create additional users and share with your team members as needed.
  2. Copy API credentials
    Access your test API credentials to start making test transactions.
  3. Request additional test payment methods
    Add the payment methods you are interested in offering for your shoppers. Some payment methods might require additional integration work.
  4. Determine testing account structure
    Adyen provides a two-layer account structure that gives you a lot of flexibility. Determine an initial structure for testing that will best represent what you will do once your are processing live. You will have another opportunity when going live to finalize your account structure.

Make a payment

The core of your Adyen integration is being able to make payments and handle their subsequent states.

  1. Make an authorized payment
    Make a successful payment with any of our Online Payments integrations.
  2. Handle errored or refused payments
    Make sure you can handle an errored or refused payments.
  3. Refund and/or cancel a payment
    It is important to handle situations where you may need to refund or cancel your users transaction.
  4. Create a token (optional)
    Tokenize payment details, and use them again for later transactions.
  5. Integrate additional payment methods
    Add additional payment methods to your account for your shoppers' countries. It is also important you can handle the different result codes, such as pending, which is more common for local payment methods.

Notification webhooks

Adyen relies on our notification webhooks to inform your system on payment statuses and other events that are required in some situations, such as knowing the result of a refund API call, or receiving the payment result of some local payment methods.

  1. Expose an endpoint to handle notifications
    You need to expose an endpoint in your system to be able to receive our webhooks.
  2. Configure the notification webhooks to send to your endpoint
    Login to the Customer Area in order to set the endpoint of your webhook handler.
  3. Receive and accept a notification
    Successfully handle and process our different notification eventCodes.

Reports and reconciliation

Understanding and parsing our reports is crucial for reconciliation.

  1. Download the Settlement details report automatically
    The Settlement details report is the main reconciliation report and is generated for each payout we make to you.
  2. Build out reconciliation process
    We provide guidance on how to automate your payment reconciliation.

Going live

To start accepting payments from your shoppers, you need to apply for a live account.

After you receive the credentials for your live Customer Area account, follow our go-live checklist.