---
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-06-01T15:33:14+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.                                                             | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| Make a partial payment with a gift card and the rest with another payment method.                             | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| Confirm an additional action on your server.                                                                  | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| Confirm a redirect on your server.                                                                            | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| Implement checks on your server, like inventory checks, before making a payment.                              | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| Update the payment amount before making a payment, for example, when the shopper updates their shopping cart. |                                                                                             | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| Implement Apple Pay and Google Pay [express checkout](/payment-methods/express-checkout).                     |                                                                                             |                                                                                             | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| Change the order of payment methods for an individual transaction.                                            |                                                                                             |                                                                                             | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| Insert a separate page for the shopper to agree to terms and conditions before making a payment.              |                                                                                             |                                                                                             | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |

### 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)
