Are you looking for test card numbers?

Would you like to contact support?

Developer-resource icon

Integration checklist

Understand core steps to ensure are taken care of before processing live payments.

It is important your integration is complete when building into 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 integrations: Online Payments and/or Point of sale.
  2. Handle errored or refused payments
    Make sure you can handle an errored or refused payments. Point of sale has its own handling for errored and 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)
    Be able to tokenize payment details, both Online and in-person, 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.

Notifications 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 CA notifications to send to your endpoint
    Login to the CA 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 are 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

After you have built out your integration to Adyen, you will want to go live. Follow the steps below to make sure you are ready for live processing.

  1. Request account to be taken live
    Log in to your Customer Area and apply to take your account live, where you will need to provide your business information. You will be given login credentials for our live platform once you are completed.
  2. Request additional payment methods
    Make sure you requested all payment methods you want to process for your shoppers.
  3. Access live Customer Area
    Use the live credentials provided earlier to successfully log in to the live Customer Area.
  4. Create merchant account structure
    Make sure your live account structure best represents your business needs.
  5. Update account settings
    When your account is taken live, some settings are copied over, but you need to update the settings for the following:
  6. Set up risk configurations
    It's important that risk management is set up to handle live transactions, including selecting a risk profile that best matches your business.
  7. Add a payout account
    Provide information for the payout account where you want to receive payments.
  8. Migrate tokens and shopper details (optional)
    When moving to Adyen, you will need to migrate the payment data from your previous provider, such as tokenized card details.
  9. Update code base
    Update your code base and account settings for our live platform.
    • Switch to live API credentials
      Generate a new API key on your live account and copy to your live platform.
    • Switch your test endpoints to your live, custom URLs
      Update the Adyen endpoints you used in test to your live endpoints. Your customized live endpoints are unique for your account and improve your security.
  10. End-to-end test
    Ensure your platform can handle the entire payment lifecycle from authorization and refusals through payout and reconciliation. We suggest testing the following:

    • Payments:

      • Test the happy flow by making payments with real cards, and payments with real details for other payment methods that you support.
      • Test non-happy payment flows to ensure your integration can handle errors and refusal reasons.
      • Test the 3D Secure flow, if you implemented that.

    • Payment modifications, like cancelling and refunding.
    • Notification webhooks: Confirm you are able to acknowledge any notification type with an [accepted] response, to prevent notifications being queued.
    • Order handling.
    • Bank statements: Verify that payments appear correctly on the shopper's bank statement.
    • Payouts: Confirm you receive a payout and corresponding Settlement details report.
    • Reconciliation: Confirm your system completes the reconciliation process.

Next steps