{"title":"Agentic Checkout API Integration","category":"default","creationDate":1766481060,"content":"

The Adyen Agentic Checkout API acts as a unified integration layer that creates a bridge between AI-driven shopping agents (like Gemini, ChatGPT, and Copilot) and your commerce ecosystems. You integrate with our API, and we handle the translation between different commerce protocols. This makes it so that you do not need to integrate with multiple protocols, while enabling you to continue processing payments with your existing Adyen integration.<\/p>\n

Our Agentic Checkout layer handles the complexity of orchestrating between diverse standards (like Google\u2019s Universal Commerce Protocol (UCP<\/a>)<\/strong> and OpenAI\u2019s Agentic Commerce Protocol (ACP<\/a>)<\/strong>, currently the two most widely adopted protocols in the industry).<\/p>\n

Requirements<\/h2>\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nAn existing online payments<\/a> integration.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

How it works<\/h2>\n

For a visual diagram representation, go to \n Sequence diagrams<\/strong>\n<\/a>.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n
Step<\/th>\nName<\/th>\nRequirement<\/th>\nEndpoint<\/th>\nDirection<\/th>\nPurpose<\/th>\nRelated ACP endpoint<\/th>\nRelated UCP endpoint<\/th>\n<\/tr>\n<\/thead>\n
1<\/td>\nAgentic checkout configuration<\/a><\/strong><\/td>\nMANDATORY<\/strong> (can be one-time request)<\/td>\nPOST \/agentic\/configuration<\/code><\/td>\nYour server \u2192 Adyen<\/td>\nConfigures the endpoints that the merchant wants to implement.<\/td>\n<\/td>\n<\/td>\n<\/tr>\n
2<\/td>\n\n Create or Update session<\/strong>\n<\/a><\/td>\nMANDATORY<\/strong><\/td>\nPOST \/agentic\/sessions\/{sessionId}<\/code><\/td>\nAdyen \u2192 Merchant<\/td>\nSynchronizes stock and shipping data to maintain updated cart totals.<\/td>\nCreate session<\/a> and Update session<\/a><\/td>\nCreate checkout<\/a> and Update checkout<\/a><\/td>\n<\/tr>\n
3<\/td>\n\n Commit session (pre payment validation)<\/strong>\n<\/a><\/td>\nOPTIONAL<\/td>\nPOST \/agentic\/sessions\/{sessionId}\/commit<\/code><\/td>\nAdyen \u2192 Your server<\/td>\nFinal pre-auth gate, sends payment data and risk signals to merchants. Is triggered before the payment.<\/td>\nComplete session<\/a><\/td>\nComplete checkout<\/a><\/td>\n<\/tr>\n
4<\/td>\n\n Cancel session<\/strong>\n<\/a><\/td>\nOPTIONAL<\/td>\nPOST \/agentic\/sessions\/{sessionId}\/cancel<\/code><\/td>\nAdyen \u2192 Your server<\/td>\nNotifies merchants if the agentic checkout is aborted.<\/td>\nCancel session<\/a><\/td>\nCancel checkout<\/a><\/td>\n<\/tr>\n
5<\/td>\n\n Finalize session<\/strong>\n<\/a><\/td>\nMANDATORY<\/strong><\/td>\nStandard Webhook OR<\/strong> POST \/agentic\/sessions\/{sessionId}\/finalize<\/code><\/td>\nAdyen \u2192 Your server<\/td>\nStandard authorization webhook with extra agentic metadata. Is triggered after the payment. Merchant fulfills the order based on this event<\/td>\nComplete session<\/a><\/td>\nComplete checkout<\/a><\/td>\n<\/tr>\n
6<\/td>\nComplete session (advanced flow)<\/a><\/strong><\/td>\nOPTIONAL<\/strong><\/td>\nPOST \/agentic\/sessions\/{sessionId}\/complete<\/code><\/td>\nAdyen \u2192 Your server<\/td>\nDelivers payment data to the merchant, allowing the merchant to execute the payment directly by making a \/payments<\/a> request and fulfill the order in one synchronous step.<\/td>\nComplete session<\/a><\/td>\nComplete checkout<\/a><\/td>\n<\/tr>\n
7<\/td>\n\n Post-Purchase Events<\/strong>\n<\/a><\/td>\nOPTIONAL<\/td>\nPOST \/agentic\/sessions\/{sessionId}\/events<\/code><\/td>\nYour server \u2192 Adyen<\/td>\nPush tracking\/status updates for AI follow-up.<\/td>\nCheckout webhooks<\/a><\/td>\nOrder capability events<\/a><\/td>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

1. Agentic Checkout Configuration<\/h2>\n

Endpoint:<\/strong> POST \/agentic\/configuration<\/code>
\nDirection:<\/strong> Your server \u2192 Adyen (API Call)
\nRequirement:<\/strong> Mandatory <\/p>\n

Before processing agentic transactions, the merchant must register their endpoints\/webhooks with Adyen. This is typically a one-time setup during onboarding or updated when the merchant\u2019s infrastructure changes.<\/p>\n

\n <\/code-sample>\n<\/div>\n

Example:<\/strong> If enableCommitEndpoint<\/code> is true<\/code>, Adyen will attempt to call {baseUrl}\/agentic\/sessions\/{id}\/commit<\/code>. If false<\/code>, Adyen skips this step and proceeds directly to authorization.<\/p>\n

2. Create or update session<\/h2>\n

Endpoint:<\/strong> POST \/agentic\/sessions\/{sessionId}<\/code>
\nDirection:<\/strong> Adyen \u2192 Your server
\nRequirement:<\/strong> Mandatory<\/p>\n

It serves as the live calculator for the AI Agent to determine final amounts and stock availability. As the shopper interacts with the agent and provides a delivery address and changes quantities, Adyen calls this endpoint to ensure the agent has the most accurate data of the checkout session. This endpoint is used for:<\/p>\n