# adyen/adyen-salesforce-commerce-cloud architecture

> Architecture diagram of the GitHub repository adyen/adyen-salesforce-commerce-cloud, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adyen/adyen-salesforce-commerce-cloud
- Repository: https://github.com/adyen/adyen-salesforce-commerce-cloud

## Overview

This is Adyen’s Salesforce Commerce Cloud SFRA cartridge: it integrates storefront payments with Adyen Checkout and Terminal APIs. Shoppers select a payment method, the storefront renders Adyen Web Components, submits payment state to SFCC, and the server-side cartridge handles payment and confirmation; asynchronous notifications update payment/order state. The graph also preserves documented POS, express checkout, gift cards/partial payments, Business Manager configuration, and analytics. README-level relationships are cited as documented; some server-side wiring is unsampled, so uncertain links are omitted.

Main entry points: [`src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/index.js`](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/index.js) (Checkout UI), [`src/cartridges/int_adyen_SFRA/cartridge/controllers/CheckoutServices.js`](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/controllers/CheckoutServices.js) (Checkout endpoints), [`src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/renderPaymentMethod.js`](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/renderPaymentMethod.js) (Payment renderer), [`src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/giftcards/index.js`](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/giftcards/index.js) (Gift cards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront payments"]
  node_checkout_ui["Checkout UI<br/>[index.js]"]
  node_payment_render["Payment renderer"]
  node_payment_config["Method configuration<br/>[index.js]"]
  node_checkout_state["Checkout state<br/>[store.js]"]
  node_browser_http["Browser HTTP<br/>[httpClient.js]"]
  node_express["Express payments"]
  node_gift_cards["Gift cards<br/>[index.js]"]
end

subgraph group_server["Payment services"]
  node_server_checkout["Checkout endpoints"]
  node_payment_methods["Payment methods"]
  node_component_payment["Component payment"]
  node_place_order["Place order<br/>[placeOrder.js]"]
  node_confirmation["Payment confirmation"]
  node_partial_payments["Partial payments<br/>[partialPayment.js]"]
  node_pos["POS terminal"]
end

subgraph group_operations["Operations and events"]
  node_webhook_receiver["Webhook receiver<br/>[notify.js]"]
  node_webhook_handlers["Notification handlers<br/>[AUTHORISATION.js]"]
  node_analytics["Payment analytics"]
end

subgraph group_admin["Administration"]
  node_business_manager["Business Manager setup<br/>[AdyenSettings.js]"]
end

node_shopper(("Shopper"))
node_adyen{{"Adyen services"}}

node_shopper -->|"selects payment"| node_checkout_ui
node_checkout_ui -->|"renders methods"| node_payment_render
node_checkout_ui -->|"configures methods"| node_payment_config
node_checkout_ui -->|"updates state"| node_checkout_state
node_checkout_ui -->|"renders gift cards"| node_gift_cards
node_checkout_ui -.->|"sends requests"| node_browser_http
node_checkout_ui -.->|"supports express"| node_express
node_payment_render -->|"renders components"| node_adyen
node_shopper -->|"starts express checkout"| node_express
node_checkout_ui -->|"requests checkout"| node_server_checkout
node_server_checkout -.->|"fetches methods"| node_payment_methods
node_server_checkout -.->|"submits payment"| node_component_payment
node_server_checkout -.->|"places order"| node_place_order
node_place_order -.->|"confirms payment"| node_confirmation
node_component_payment -->|"uses Checkout API"| node_adyen
node_shopper -->|"pays at terminal"| node_pos
node_pos -->|"uses Terminal API"| node_adyen
node_gift_cards -.->|"manages balances"| node_partial_payments
node_adyen -.->|"sends notifications"| node_webhook_receiver
node_webhook_receiver -.->|"dispatches events"| node_webhook_handlers
node_webhook_handlers -.->|"records outcomes"| node_analytics
node_business_manager -.->|"configures payments"| node_shopper

click node_checkout_ui "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/index.js"
click node_payment_render "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/renderPaymentMethod.js"
click node_payment_config "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/paymentMethodsConfiguration/index.js"
click node_checkout_state "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/config/store.js"
click node_browser_http "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/commons/httpClient.js"
click node_express "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/express/initializeCheckout.js"
click node_gift_cards "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/giftcards/index.js"
click node_server_checkout "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/controllers/CheckoutServices.js"
click node_payment_methods "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/payments/getCheckoutPaymentMethods.js"
click node_component_payment "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/payments/paymentFromComponent.js"
click node_place_order "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/controllers/middlewares/checkout_services/placeOrder.js"
click node_confirmation "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/showConfirmation/showConfirmation.js"
click node_partial_payments "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/partialPayments/partialPayment.js"
click node_pos "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/pos/adyenTerminalApi.js"
click node_webhook_receiver "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_webhooks/cartridge/notify.js"
click node_webhook_handlers "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_webhooks/cartridge/eventHandlers/AUTHORISATION.js"
click node_analytics "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/adyen/analytics/analyticsService.js"
click node_business_manager "https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/bm_adyen/cartridge/controllers/AdyenSettings.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_checkout_ui,node_payment_render,node_payment_config,node_checkout_state,node_browser_http,node_express,node_gift_cards toneBlue
class node_server_checkout,node_payment_methods,node_component_payment,node_place_order,node_confirmation,node_partial_payments,node_pos toneAmber
class node_webhook_receiver,node_webhook_handlers,node_analytics toneMint
class node_business_manager toneRose
class node_shopper,node_adyen toneIndigo
```

## Components

### Storefront payments

- [Checkout UI](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/index.js): `src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/index.js`
- [Payment renderer](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/renderPaymentMethod.js): `src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/renderPaymentMethod.js`
- [Method configuration](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/paymentMethodsConfiguration/index.js): `src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/paymentMethodsConfiguration/index.js`
- [Checkout state](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/config/store.js): `src/cartridges/app_adyen_SFRA/cartridge/config/store.js`
- [Browser HTTP](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/commons/httpClient.js): `src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/commons/httpClient.js`
- [Express payments](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/express/initializeCheckout.js): `src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/express/initializeCheckout.js`
- [Gift cards](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/giftcards/index.js): `src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/giftcards/index.js`

### Payment services

- [Checkout endpoints](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/controllers/CheckoutServices.js): `src/cartridges/int_adyen_SFRA/cartridge/controllers/CheckoutServices.js`
- [Payment methods](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/payments/getCheckoutPaymentMethods.js): `src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/payments/getCheckoutPaymentMethods.js`
- [Component payment](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/payments/paymentFromComponent.js): `src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/payments/paymentFromComponent.js`
- [Place order](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/controllers/middlewares/checkout_services/placeOrder.js): `src/cartridges/int_adyen_SFRA/cartridge/controllers/middlewares/checkout_services/placeOrder.js`
- [Payment confirmation](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/showConfirmation/showConfirmation.js): `src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/showConfirmation/showConfirmation.js`
- [Partial payments](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/partialPayments/partialPayment.js): `src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/partialPayments/partialPayment.js`
- [POS terminal](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/pos/adyenTerminalApi.js): `src/cartridges/int_adyen_SFRA/cartridge/adyen/scripts/pos/adyenTerminalApi.js`

### Operations and events

- [Webhook receiver](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_webhooks/cartridge/notify.js): `src/cartridges/int_adyen_webhooks/cartridge/notify.js`
- [Notification handlers](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_webhooks/cartridge/eventHandlers/AUTHORISATION.js): `src/cartridges/int_adyen_webhooks/cartridge/eventHandlers/AUTHORISATION.js`
- [Payment analytics](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/int_adyen_SFRA/cartridge/adyen/analytics/analyticsService.js): `src/cartridges/int_adyen_SFRA/cartridge/adyen/analytics/analyticsService.js`

### Administration

- [Business Manager setup](https://github.com/adyen/adyen-salesforce-commerce-cloud/blob/main/src/cartridges/bm_adyen/cartridge/controllers/AdyenSettings.js): `src/cartridges/bm_adyen/cartridge/controllers/AdyenSettings.js`

### Other components

- **Shopper**
- **Adyen services**

## Connections

- Shopper → Checkout UI: selects payment (evidence: `README.md`)
- Checkout UI → Payment renderer: renders methods (evidence: `src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/index.js`)
- Checkout UI → Method configuration: configures methods (evidence: `src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/index.js`)
- Checkout UI → Checkout state: updates state (evidence: `src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/index.js`)
- Checkout UI → Gift cards: renders gift cards (evidence: `src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/index.js`)
- Checkout UI → Browser HTTP: sends requests (evidence: `src/cartridges/app_adyen_SFRA/cartridge/client/default/js/adyen/checkout/index.js`)
- Checkout UI → Express payments: supports express
- Payment renderer → Adyen services: renders components (evidence: `README.md`)
- Shopper → Express payments: starts express checkout (evidence: `README.md`)
- Checkout UI → Checkout endpoints: requests checkout (evidence: `README.md`)
- Checkout endpoints → Payment methods: fetches methods
- Checkout endpoints → Component payment: submits payment
- Checkout endpoints → Place order: places order
- Place order → Payment confirmation: confirms payment
- Component payment → Adyen services: uses Checkout API (evidence: `README.md`)
- Shopper → POS terminal: pays at terminal (evidence: `README.md`)
- POS terminal → Adyen services: uses Terminal API (evidence: `README.md`)
- Gift cards → Partial payments: manages balances
- Adyen services → Webhook receiver: sends notifications
- Webhook receiver → Notification handlers: dispatches events
- Notification handlers → Payment analytics: records outcomes
- Business Manager setup → Shopper: configures payments
