Default icon

Standard payments integration

Learn to set up your account and a standard payments integration with Adyen.

View source

If you are new to Adyen, you can follow this self-contained set of pages that guide you through implementing a standard online payments integration. This integration includes a set of features that minimizes the complexity of building a payments integration. Our pre-built user interfaces allow you to manage your account and transactions with ease, so that you can focus on other tasks for your business.

With a standard integration, you can:

  • Accept payments with minimal server-side implementation and our pre-built client-side UI.
  • Stay compliant with payment industry regulations out-of-the-box.
  • Manage your account, transactions, and reports from the Customer Area.
  • Access essential risk management and dispute handling tools.

How to use this checklist

This checklist guides you through building a standard online payments integration. It links out to other parts of the Adyen documentation set when necessary.

We highly recommend that you do not navigate outside of the sections that we directly link to from this page. The documentation outside of this path (/standard), contains additional features and configurations that you cannot use with the standard integration.

Standard integration checklist

Create your Adyen account and configure your settings.

  1. Create your Adyen test account.
  2. Meet the requirements for your live account application.
  3. Configure your Adyen account structure and learn how to manage it.
  4. Manage the users in your account.
  5. Assign user roles.
  6. Set up Multifactor authentication (MFA) for your users.
  7. Set up single sign-on (SSO).
  8. Configure notifications for your users.

Integration

Build your payments integration using our standard single-request API flow. You can choose between rendering the payment form on your website (Drop-in) or redirecting to an Adyen-hosted payment page (Hosted Checkout).

  1. Review the integration checklist.
  2. Build your online payments integration.
  3. View supported payment methods.
  4. Add payment methods to your Customer Area account.
  5. If you integrated with Drop-in: Follow the best practices.
  6. Allowlist Adyen IP addresses.
  7. Protect sensitive data.
  8. Handle security incidents.

Payments

Understand how payments work and how to modify them after authorization.

  1. Understand the payments lifecycle.
  2. Manage payments (refund, cancel, capture).
  3. Add a transaction description.
  4. Handle result codes.
  5. Configure checkout settings.

Risk and disputes

Protect your business from fraud and manage chargebacks.

  1. Configure a risk profile.
  2. Set up risk lists.
  3. Configure post-auth rules.
  4. Understand the dispute flow.
  5. Know the dispute timeframes.
  6. Defend and manage disputes.
  7. Monitor risk and disputes.

Finance

Track your balances and configure how you receive payouts.

  1. Understand your balances.
  2. Learn how you get paid.
  3. Manage your balances.
  4. View your balances.
  5. Manage your payout accounts.
  6. Set up sales day payout.
  7. Check supported payout currencies.
  8. Configure your invoice settings.

Reports

Use reports to reconcile transactions and monitor your payment activity.

  1. Overview.
  2. Generate and download reports.
  3. Use the Payment accounting report.
  4. Use the Settlement details report.
  5. View disputed transactions.
  6. Understand reports and the payment lifecycle.

Test & go live

Test your integration and prepare to accept live payments.

  1. Test your integration
  2. Test result codes and refusal reasons
  3. Use test cards and credentials
  4. Check your logs
  5. Switch to live endpoints
  6. Complete the go-live checklist

References

Look up codes and technical details.

  1. Look up currency codes
  2. Look up HTTP status codes
  3. Look up error codes
  4. Look up refusal reasons
  5. Look up dispute reason codes
  6. Understand raw acquirer responses