Search

Are you looking for test card numbers?

Would you like to contact support?

Point-of-sale icon

Get started with your point-of-sale integration

Checklist for building a point-of-sale integration with Adyen.

Step 1: Set up an Adyen test account

The first thing you need to do, is to get an Adyen test account.

  1. Sign up for a test account.
    You'll get:

    • One company account that represents your core business entity with us.
    • One merchant account.
    • Access to your test Customer Area as an Admin user. In the Customer Area you can manage your account, order payment terminals, view transactions, and add users.
  2. Determine and set up your account structure.
    You now need to create a structure of one or more merchant accounts that either represent stores or have stores underneath. You can add more merchant accounts and stores later, but the basic structure should reflect the structure that you plan to have when you go live.

  3. Apply for a live account. This process takes some time, because we are legally obliged to do thorough checks. While you wait for a live account, you can start integrating using your test account. However, you may wish to wait for the result of your application to be confirmed first.

Step 2: Scope your point-of-sale integration

The next step is to determine the scope of your integration.

This might also be a good time to learn about our Terminal API and the payments lifecyle.

  1. Choose your integration architecture:

    • With local communications your cash register communicates directly with the payment terminal over your local network.
    • With cloud communications your cash register communicates with the payment terminal through the Adyen payments platform.

  2. Determine the payment features you want to support.

  3. Determine your encryption needs.
    By default, we protect payment messages with our End-to-End Encryption (E2EE) solution, but we also offer Point-to-Point Encryption (P2PE). Both are equally secure. If you require P2PE, you need to inform us because we then need to provide different software on your payment terminals.

Step 3: Choose payment terminals

Now let's focus on the devices for processing payments. These devices are sometimes referred to as pin entry devices (PED) or points of interaction (POI), but we call them terminals.

  1. Select the terminal models that suit your business.

  2. Order test terminals from your test Customer Area.

  3. Board your terminals, to associate them with a store and make them ready to accept payments.

Step 4: Configure features

Set up the features that your payment terminals should support.

  1. Enable Terminal API on your Customer Area company account.

  2. Add payment methods. Your payment terminals accept the global credit cards and Maestro out-of-the-box. If you also want to accept local credit or debit cards, wallets, or gift cards, you need to add these payment methods to your account.

  3. Configure the payment features that are in the scope you decided on.

Step 5: Build your integration

Now you can start building your integration, and then test if everything works.

  1. Add users to your account.
    You already have a Customer Area user (the Admin user) and a default web service user: ws@Company.[YourCompanyAccount]. (You can't log in with your web service user; our system uses it for flows that require authentication, such as processing payments and ordering payment terminals.)

  2. Depending on the integration architecture that you chose, either:

    This involves configuring your network, optionally installing an API library, and building a flow for receiving payment results.

    While doing this, make sure you implement our network recommendations and best practices.

  3. Test your integration.

  4. Learn how to handle Terminal API errors and troubleshoot your terminals.

  5. Ensure your reconciliation is working.

Step 6: Go live

After testing your integration for all the features you plan to use, you can take your integration live.

  1. When you have the login credentials for your live account, set up your account structure.
  2. Configure your live account with the payment methods and features that you want to use.
  3. Add web service users and Customer Area users. Note that we don't create a default web service user for your live account.
  4. Order terminals for live payments and configure them.
  5. Add a payout account to each of your live merchant accounts.
  6. Update your code:
    • For a cloud integration, generate a new API key and switch to the live endpoints and the new API key.
    • For a local integration, secure the communication with the LIVE terminal certificate (or use a library).
  7. Do end-to-end tests, from making a payment with a real card to completing your reconciliation.