{"title":"Build your integration","category":"default","creationDate":1776961627,"content":"

You can integrate Adyen's client-side libraries<\/a> with different server-side flows. Sessions flow is the default integration that we recommend and that meets the requirements for most online payments integrations.<\/p>\n

Choose your server-side implementation<\/h2>\n

Before you integrate with a client-side library, choose the server-side flow depending on the technical details and depending on the use cases<\/a> that you want your integration to support.<\/p>\n

\n

Sessions flow: a single API request<\/h3>

Your server makes a single Checkout API request to the \/sessions<\/a> 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<\/a>.
\"\"<\/a><\/p><\/div>

Advanced flow: three API requests<\/h3>

Your server makes three Checkout API requests: \/paymentMethods<\/a>, \/payments<\/a>, and \/payments\/details<\/a>. Adyen sends payment data from our server to your server. This flow supports more use cases.
\"\"<\/a><\/p><\/div><\/div>\n

\n \n
\n
\n <\/i>\n
\n

Sessions flow with additional methods<\/h3>\n <\/div>\n <\/div>\n
\n \n

The client-side libraries include additional methods that to make requests from your server to the \/payments<\/a> and \/payments\/details<\/a> endpoints, so that you get responses on your server.
\n\n \"\"\n<\/a><\/p>\n\n <\/div>\n <\/div>\n<\/div>\n\n

Supported use cases<\/h3>\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Description<\/th>\nSessions flow<\/th>\nSessions flow with additional methods<\/th>\nAdvanced flow<\/th>\n<\/tr>\n<\/thead>\n
Make a payment with any available payment method.<\/td>\n\"-white_check_mark-\"<\/td>\n\"-white_check_mark-\"<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
Make a partial payment with a gift card and the rest with another payment method.<\/td>\n\"-white_check_mark-\"<\/td>\n\"-white_check_mark-\"<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
Confirm an additional action on your server.<\/td>\n\"-white_check_mark-\"<\/td>\n\"-white_check_mark-\"<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
Confirm a redirect on your server.<\/td>\n\"-white_check_mark-\"<\/td>\n\"-white_check_mark-\"<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
Implement checks on your server, like inventory checks, before making a payment.<\/td>\n\"-white_check_mark-\"<\/td>\n\"-white_check_mark-\"<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
Update the payment amount before making a payment, for example, when the shopper updates their shopping cart.<\/td>\n<\/td>\n\"-white_check_mark-\"<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
Implement Apple Pay and Google Pay express checkout<\/a>.<\/td>\n<\/td>\n<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
Change the order of payment methods for an individual transaction.<\/td>\n<\/td>\n<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
Insert a separate page for the shopper to agree to terms and conditions before making a payment.<\/td>\n<\/td>\n<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Integration comparison<\/h3>\n\n\n\n\n\n\n\n\n
Integration features<\/th>\nSessions flow<\/th>\nSessions flow with additional methods<\/th>\nAdvanced flow<\/th>\n<\/tr>\n<\/thead>\n
Integration effort<\/td>\nLight<\/td>\nMedium<\/td>\nMedium<\/td>\n<\/tr>\n
Number of endpoint requests from your server<\/td>\n1<\/td>\n2 or 3<\/td>\n3<\/td>\n<\/tr>\n
Handling redirects<\/td>\nClient-side<\/td>\nClient-side and server-side<\/td>\nClient-side and server-side<\/td>\n<\/tr>\n
Handling additional actions<\/td>\nClient-side<\/td>\nClient-side and server-side<\/td>\nClient-side and server-side<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Get started<\/h2>\n

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.<\/p>\n

\n

Sessions flow<\/h6>

Your server makes one Checkout API request.<\/p><\/div><\/p><\/a>

Advanced flow<\/h6>

Your server makes three Checkout API requests.<\/p><\/div><\/p><\/a><\/div>\n","url":"https:\/\/docs.adyen.com\/online-payments\/build-your-integration","articleFields":{"description":"Start building your server-side integration","feedback_component":false,"process":{"markdown":true,"twig":true},"twig_first":true,"never_cache_twig":true,"filters_component":false},"algolia":{"url":"https:\/\/docs.adyen.com\/online-payments\/build-your-integration","title":"Build your integration","content":"You can integrate Adyen's client-side libraries with different server-side flows. Sessions flow is the default integration that we recommend and that meets the requirements for most online payments integrations.\nChoose your server-side implementation\nBefore you integrate with a client-side library, choose the server-side flow depending on the technical details and depending on the use cases that you want your integration to support.\n\nSessions flow: a single API requestYour server makes a single Checkout API request to the \/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.Advanced flow: three API requestsYour server makes three Checkout API requests: \/paymentMethods, \/payments, and \/payments\/details. Adyen sends payment data from our server to your server. This flow supports more use cases.\n\n \n \n \n \n \n Sessions flow with additional methods\n \n \n \n \nThe client-side libraries include additional methods that to make requests from your server to the \/payments and \/payments\/details endpoints, so that you get responses on your server.\n\n \n\n\n \n \n\n\nSupported use cases\n\n\n\nDescription\nSessions flow\nSessions flow with additional methods\nAdvanced flow\n\n\n\n\nMake a payment with any available payment method.\n\n\n\n\n\nMake a partial payment with a gift card and the rest with another payment method.\n\n\n\n\n\nConfirm an additional action on your server.\n\n\n\n\n\nConfirm a redirect on your server.\n\n\n\n\n\nImplement checks on your server, like inventory checks, before making a payment.\n\n\n\n\n\nUpdate the payment amount before making a payment, for example, when the shopper updates their shopping cart.\n\n\n\n\n\nImplement Apple Pay and Google Pay express checkout.\n\n\n\n\n\nChange the order of payment methods for an individual transaction.\n\n\n\n\n\nInsert a separate page for the shopper to agree to terms and conditions before making a payment.\n\n\n\n\n\n\nIntegration comparison\n\n\n\nIntegration features\nSessions flow\nSessions flow with additional methods\nAdvanced flow\n\n\n\n\nIntegration effort\nLight\nMedium\nMedium\n\n\nNumber of endpoint requests from your server\n1\n2 or 3\n3\n\n\nHandling redirects\nClient-side\nClient-side and server-side\nClient-side and server-side\n\n\nHandling additional actions\nClient-side\nClient-side and server-side\nClient-side and server-side\n\n\n\nGet started\nChoose 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.\n\nSessions flowYour server makes one Checkout API request.Advanced flowYour server makes three Checkout API requests.\n","type":"page","locale":"en","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Online payments","lvl2":"Build your integration"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/online-payments","lvl2":"\/online-payments\/build-your-integration"},"levels":3,"category":"Online Payments","category_color":"green","tags":["Build","integration"]},"articleFiles":{"advanced-flow.svg":"\"\"","sessions-flow-with-additional-methods.svg":"\"\"","sessions-flow.svg":"\"\""}}