--- title: "Build your integration" description: "Start building your server-side integration" url: "https://docs.adyen.com/online-payments/build-your-integration" source_url: "https://docs.adyen.com/online-payments/build-your-integration.md" canonical: "https://docs.adyen.com/online-payments/build-your-integration" last_modified: "2026-07-17T16:24:24+02:00" language: "en" --- # Build your integration Start building your server-side integration [View source](/online-payments/build-your-integration.md) You can integrate Adyen's [client-side libraries](https://github.com/Adyen/#client-side) with different server-side flows. Sessions flow is the default integration that we recommend and that meets the requirements for most online payments integrations. ## Choose your server-side implementation Before you integrate with a client-side library, choose the server-side flow depending on the technical details and depending on the [use cases](#supported-use-cases) that you want your integration to support. ### Sessions flow: a single API request Your server makes a single Checkout API request to the [/sessions](https://docs.adyen.com/api-explorer/Checkout/latest/post/sessions) endpoint. Adyen sends payment data from our server to your client-side application. You can optionally implement additional client-side methods to support some [additional use cases](#sessions-flow-with-additional-methods).\ [![](/user/pages/docs/02.online-payments/07.build-your-integration/sessions-flow.svg)](/user/pages/docs/02.online-payments/07.build-your-integration/sessions-flow.svg) ### Advanced flow: three API requests Your server makes three Checkout API requests: [/paymentMethods](https://docs.adyen.com/api-explorer/Checkout/latest/post/paymentMethods), [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments), and [/payments/details](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments/details). Adyen sends payment data from our server to your server. This flow supports more use cases.\ [![](/user/pages/docs/02.online-payments/07.build-your-integration/advanced-flow.svg)](/user/pages/docs/02.online-payments/07.build-your-integration/advanced-flow.svg) ** ### Sessions flow with additional methods The client-side libraries include additional methods that to make requests from your server to the [/payments](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments) and [/payments/details](https://docs.adyen.com/api-explorer/Checkout/latest/post/payments/details) endpoints, so that you get responses on your server.\ [![](/user/pages/docs/02.online-payments/07.build-your-integration/sessions-flow-with-additional-methods.svg)](/user/pages/docs/02.online-payments/07.build-your-integration/sessions-flow-with-additional-methods.svg) ### Supported use cases | Description | Sessions flow | Sessions flow with additional methods | Advanced flow | | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | | Make a payment with any available payment method. | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | | Make a partial payment with a gift card and the rest with another payment method. | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | | Confirm an additional action on your server. | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | | Confirm a redirect on your server. | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | | Implement checks on your server, like inventory checks, before making a payment. | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | | Update the payment amount before making a payment, for example, when the shopper updates their shopping cart. | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | | Implement Apple Pay and Google Pay [express checkout](/payment-methods/express-checkout). | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | | Change the order of payment methods for an individual transaction. | | | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | | Insert a separate page for the shopper to agree to terms and conditions before making a payment. | | | ![Required](/user/pages/reuse/image-library/01.icons/required/required.svg?decoding=auto\&fetchpriority=auto) | ### Integration comparison | Integration features | Sessions flow | Sessions flow with additional methods | Advanced flow | | -------------------------------------------- | ------------- | ------------------------------------- | --------------------------- | | Integration effort | Light | Medium | Medium | | Number of endpoint requests from your server | 1 | 2 or 3 | 3 | | Handling redirects | Client-side | Client-side and server-side | Client-side and server-side | | Handling additional actions | Client-side | Client-side and server-side | Client-side and server-side | ## Get started Choose the server-side implementation that meets your needs to learn how to integrate with Adyen. We offer solutions for web, mobile devices, and cross-platform. ###### [Sessions flow](/online-payments/build-your-integration/sessions-flow) [Your server makes one Checkout API request.](/online-payments/build-your-integration/sessions-flow) ###### [Advanced flow](/online-payments/build-your-integration/advanced-flow) [Your server makes three Checkout API requests.](/online-payments/build-your-integration/advanced-flow)