\n| 404<\/td>\n | Not Found<\/td>\n | Session ID does not exist or has expired.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n3. Update Session<\/h2>\nUpdates an existing session with new items, address, buyer details, or a fulfillment selection. Each update re-triggers Adyen's call to the merchant's live calculator, ensuring your agent always has accurate totals.<\/p>\n Method and endpoint: POST \/checkout_sessions\/{sessionId}<\/code><\/p>\nReturns the full updated AcpCheckoutSessionResponse<\/code>. Only fields present in the request body are applied.<\/p>\nRequest body<\/h3>\nThis endpoint uses a dedicated AcpUpdateCheckoutSessionRequest<\/code> schema. Unlike Create Session, no fields are required \u2014 include only what needs to change.<\/p>\n\n\n\n| Parameter<\/th>\n | Type<\/th>\n | Required<\/th>\n | Description<\/th>\n<\/tr>\n<\/thead>\n | \n\ncurrency<\/code><\/strong><\/td>\n| string (ISO 4217)<\/td>\n | <\/td>\n | Must match the currency set at session creation if provided.<\/td>\n<\/tr>\n | \nitems<\/code><\/strong><\/td>\n| AcpItem[]<\/td>\n | <\/td>\n | Replaces the entire item list.<\/td>\n<\/tr>\n | \nbuyer<\/code><\/strong><\/td>\n| AcpBuyer<\/td>\n | <\/td>\n | Updated buyer contact information.<\/td>\n<\/tr>\n | \nfulfillment_address<\/code><\/strong><\/td>\n| AcpAddress<\/td>\n | <\/td>\n | Updated shipping address. Triggers recalculation of tax and shipping costs.<\/td>\n<\/tr>\n | \nfulfillment_option_id<\/code><\/strong><\/td>\n| string<\/td>\n | <\/td>\n | ID of the fulfillment option the shopper selected from fulfillment_options[]<\/code> in the session response.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n <\/code-sample>\n<\/div>\n\n Call Update Session whenever the shopper changes their delivery address, selects a shipping tier, or modifies cart quantity. The response line_items[].total<\/code>, fulfillment_options[].total<\/code>, and totals[]<\/code> are always authoritative \u2014 present these to the shopper before proceeding to Complete.<\/p>\n<\/div><\/div>\nStatus codes<\/h3>\n\n\n\n| HTTP<\/th>\n | Meaning<\/th>\n | Description<\/th>\n<\/tr>\n<\/thead>\n | \n\n| 200<\/td>\n | OK<\/td>\n | Session updated. Response contains the latest authoritative state.<\/td>\n<\/tr>\n | \n| 422<\/td>\n | Unprocessable<\/td>\n | Update rejected by merchant logic (for example, item now out of stock). Inspect messages[]<\/code>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n4. Complete Session<\/h2>\nFinalizes the session by submitting the payment token from your agent's Token Vault. Adyen validates the token, optionally calls the merchant's commit endpoint for a pre-authorization risk check, executes payment authorization, and returns the result \u2014 including the created order<\/code> object on success.<\/p>\nMethod and endpoint: POST \/checkout_sessions\/{sessionId}\/complete<\/code><\/p>\nSubmits payment data and triggers authorization. Returns AcpCompleteSessionResponse<\/code> \u2014 the full session state plus an order<\/code> object on successful authorization.<\/p>\nRequest body<\/h3>\n\n\n\n| Parameter<\/th>\n | Type<\/th>\n | Required<\/th>\n | Description<\/th>\n<\/tr>\n<\/thead>\n | \n\npayment_data<\/code><\/strong><\/td>\n| AcpPaymentData<\/td>\n | ![\"Required\"](\"\/user\/pages\/reuse\/image-library\/01.icons\/required\/required.svg?decoding=auto&fetchpriority=auto\") <\/span><\/td>\n | Payment token and provider. Must include provider<\/code> (for example, adyen<\/code>) and token<\/code> \u2014 the PSP transaction token from your vault's delegate_payment<\/code> call.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nExample request<\/h3>\n\n <\/code-sample>\n<\/div>\nSuccess response<\/h3>\n\n <\/code-sample>\n<\/div>\n\n Present order.permalink_url<\/code> to the shopper as their confirmation link. order.id<\/code> is the unique order identifier \u2014 use it for post-purchase communication and support queries.<\/p>\n<\/div><\/div>\nStatus codes<\/h3>\n\n\n\n| HTTP<\/th>\n | Meaning<\/th>\n | Description<\/th>\n<\/tr>\n<\/thead>\n | \n\n| 200<\/td>\n | OK<\/td>\n | Authorization executed. order<\/code> present on success; messages[]<\/code> contains details on declined authorization.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n5. (Optional) Cancel Session<\/h2>\nCancels an active session that has not been completed. Call this when the shopper abandons checkout or your agent cannot proceed. Signals the merchant to release any reserved inventory.<\/p>\n Method and endpoint: POST \/checkout_sessions\/{sessionId}\/cancel<\/code><\/p>\nNo request body required. Returns AcpCheckoutSessionResponse<\/code> with status: \"canceled\"<\/code>.<\/p>\nStatus codes<\/h3>\n\n\n\n| HTTP<\/th>\n | Meaning<\/th>\n | Description<\/th>\n<\/tr>\n<\/thead>\n | \n\n| 200<\/td>\n | OK<\/td>\n | Session canceled. Response contains the final session state with status: \"canceled\"<\/code>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\nTesting<\/h2>\nUse the sandbox environment to test end-to-end before going live. The sandbox uses the same API spec and schemas as production.<\/p>\n Use the following base URL for all sandbox requests besides Delegate Payment:<\/p>\n https:\/\/commerce-suite-test.adyen.com\/commerce-suite\/acp\/v1\/{companyAccount}<\/code><\/pre>\nSandbox endpoints<\/h3>\n\n\n\n| Operation<\/th>\n | Method<\/th>\n | Path<\/th>\n<\/tr>\n<\/thead>\n | \n\n| Create Session<\/td>\n | POST<\/code><\/td>\n\/checkout_sessions<\/code><\/td>\n<\/tr>\n\n| Get Session<\/td>\n | | | |
| | | | | | | | | | | |