# adyen/adyen-salesforce-oms architecture

> Architecture diagram of the GitHub repository adyen/adyen-salesforce-oms, 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-oms
- Repository: https://github.com/adyen/adyen-salesforce-oms

## Overview

This is an Adyen payment-gateway integration for Salesforce Order Management. Its operator workflow configures gateway credentials, site endpoints, merchant accounts, webhooks, layouts, and permissions; the runtime supports order payments, notifications, refunds, and payment links. The map includes the principal payment, webhook, and payment-link stages alongside configuration and OMS support. Several Salesforce runtime subsystems are represented from the file tree only; their internal calls are left unverified rather than inferred.

Main entry points: [`force-app/main/default/lwc/adyenOMSConfigPage/adyenOMSConfigPage.js`](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenOMSConfigPage/adyenOMSConfigPage.js) (OMS setup wizard), [`force-app/main/default/classes/AdyenOOBOController.cls`](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenOOBOController.cls) (Payment link controller), [`force-app/main/default/classes/AdyenPaymentHelper.cls`](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenPaymentHelper.cls) (Payment operations), [`force-app/main/default/classes/AdyenConfigPageController.cls`](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenConfigPageController.cls) (Setup controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Setup wizard"]
  node_wizard["OMS setup wizard"]
  node_gateway_setup["Gateway setup"]
  node_merchant_setup["Merchant setup"]
  node_webhook_setup_ui["Webhook setup"]
  node_site_setup["Site setup"]
  node_layout_setup["Layout setup"]
  node_permission_setup["Permission setup"]
  node_setup_controller["Setup controller"]
  node_merchant_controller["Merchant controller"]
  node_webhook_setup_controller["Webhook setup controller"]
  node_management_api["Management API client"]
end

subgraph group_payments["Payment processing"]
  node_payment_gateway["OMS gateway adapter"]
  node_payment_helpers["Payment operations"]
  node_authorization["Authorization handling"]
  node_capture["Capture handling"]
  node_refund["Refund handling"]
  node_salesforce_payments[("Salesforce payment records")]
  node_oms_events["OMS order events"]
end

subgraph group_webhooks["Webhook handling"]
  node_notification_handler["Notification handler"]
  node_webhook_service["Webhook service"]
  node_notification_types["Event handlers"]
  node_deployment_event["Deployment result event"]
end

subgraph group_links["Payment links"]
  node_payment_link_ui["Payment link actions"]
  node_payment_link_controller["Payment link controller"]
  node_payment_link_batch["Payment link jobs"]
  node_payment_link_records[("Payment link records")]
  node_choose_payment["Choose payment<br/>[choosePayment.js]"]
  node_confirmation["Link confirmation"]
end

node_admin(("Salesforce admin"))
node_adyen_checkout{{"Adyen Checkout API"}}
node_shopper(("Shopper"))

node_admin -.->|"configures"| node_wizard
node_wizard -.->|"steps through"| node_gateway_setup
node_wizard -.->|"steps through"| node_merchant_setup
node_wizard -.->|"steps through"| node_webhook_setup_ui
node_wizard -.->|"steps through"| node_site_setup
node_wizard -.->|"steps through"| node_layout_setup
node_wizard -.->|"steps through"| node_permission_setup
node_gateway_setup -->|"calls"| node_setup_controller
node_site_setup -->|"calls"| node_setup_controller
node_layout_setup -->|"calls"| node_setup_controller
node_permission_setup -->|"calls"| node_setup_controller
node_merchant_setup -->|"calls"| node_merchant_controller
node_merchant_setup -->|"fetches accounts"| node_management_api
node_webhook_setup_ui -->|"calls"| node_webhook_setup_controller
node_webhook_setup_ui -->|"subscribes"| node_deployment_event
node_payment_gateway -.->|"sends payment requests"| node_adyen_checkout
node_payment_gateway -.->|"delegates"| node_payment_helpers
node_payment_helpers -.->|"delegates"| node_authorization
node_payment_helpers -.->|"delegates"| node_capture
node_payment_helpers -.->|"delegates"| node_refund
node_payment_helpers -.->|"updates"| node_salesforce_payments
node_notification_handler -.->|"delegates"| node_webhook_service
node_notification_handler -.->|"dispatches"| node_notification_types
node_webhook_service -.->|"configures webhooks"| node_adyen_checkout
node_shopper -.->|"selects mode"| node_choose_payment
node_choose_payment -.->|"requests link"| node_payment_link_controller
node_payment_link_ui -.->|"invokes"| node_payment_link_controller
node_payment_link_controller -.->|"creates or updates"| node_payment_link_records
node_payment_link_batch -.->|"processes"| node_payment_link_records
node_payment_link_controller -.->|"returns link details"| node_confirmation
node_confirmation -->|"looks up order"| node_payment_link_controller
node_oms_events -.->|"triggers link flow"| node_payment_link_controller
node_payment_gateway -.->|"supports OMS orders"| node_oms_events

click node_wizard "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenOMSConfigPage/adyenOMSConfigPage.js"
click node_gateway_setup "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenConfigPagePaymentGateway/adyenConfigPagePaymentGateway.js"
click node_merchant_setup "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenConfigPageMerchantAccount/adyenConfigPageMerchantAccount.js"
click node_webhook_setup_ui "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenConfigPageWebhookSetup/adyenConfigPageWebhookSetup.js"
click node_site_setup "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenConfigPageSiteEndpoint/adyenConfigPageSiteEndpoint.js"
click node_layout_setup "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenConfigPageLayoutSetup/adyenConfigPageLayoutSetup.js"
click node_permission_setup "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenConfigPagePermissionSetup/adyenConfigPagePermissionSetup.js"
click node_setup_controller "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenConfigPageController.cls"
click node_merchant_controller "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenMerchantAccountController.cls"
click node_webhook_setup_controller "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenWebhookSetupController.cls"
click node_management_api "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenManagementAPIService.cls"
click node_payment_gateway "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenGatewayAdapter.cls"
click node_payment_helpers "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenPaymentHelper.cls"
click node_authorization "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenAuthorisationHelper.cls"
click node_capture "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenCaptureHelper.cls"
click node_refund "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenRefundHelper.cls"
click node_salesforce_payments "https://github.com/adyen/adyen-salesforce-oms/tree/main/force-app/main/default/objects/Payment"
click node_notification_handler "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenWebhookNotificationHandler.cls"
click node_webhook_service "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenWebhookService.cls"
click node_notification_types "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenNotificationHandler.cls"
click node_deployment_event "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/objects/Adyen_Metadata_Deployment_Result__e/Adyen_Metadata_Deployment_Result__e.object-meta.xml"
click node_payment_link_ui "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/PaymentLinkGenerateAction.cls"
click node_payment_link_controller "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenOOBOController.cls"
click node_payment_link_batch "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenPaymentLinkBatch.cls"
click node_payment_link_records "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/objects/Payment_Link__c/Payment_Link__c.object-meta.xml"
click node_choose_payment "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/choosePayment/choosePayment.js"
click node_confirmation "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenPblConfirmationScreen/adyenPblConfirmationScreen.js"
click node_oms_events "https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/OrderSummaryCreatedEventHandler.cls"

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_wizard,node_gateway_setup,node_merchant_setup,node_webhook_setup_ui,node_site_setup,node_layout_setup,node_permission_setup,node_setup_controller,node_merchant_controller,node_webhook_setup_controller,node_management_api toneBlue
class node_payment_gateway,node_payment_helpers,node_authorization,node_capture,node_refund,node_salesforce_payments,node_oms_events toneAmber
class node_notification_handler,node_webhook_service,node_notification_types,node_deployment_event,node_adyen_checkout toneMint
class node_payment_link_ui,node_payment_link_controller,node_payment_link_batch,node_payment_link_records,node_choose_payment,node_confirmation toneRose
class node_admin,node_shopper toneIndigo
```

## Components

### Setup wizard

- [OMS setup wizard](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenOMSConfigPage/adyenOMSConfigPage.js): `force-app/main/default/lwc/adyenOMSConfigPage/adyenOMSConfigPage.js`
- [Gateway setup](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenConfigPagePaymentGateway/adyenConfigPagePaymentGateway.js): `force-app/main/default/lwc/adyenConfigPagePaymentGateway/adyenConfigPagePaymentGateway.js`
- [Merchant setup](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenConfigPageMerchantAccount/adyenConfigPageMerchantAccount.js): `force-app/main/default/lwc/adyenConfigPageMerchantAccount/adyenConfigPageMerchantAccount.js`
- [Webhook setup](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenConfigPageWebhookSetup/adyenConfigPageWebhookSetup.js): `force-app/main/default/lwc/adyenConfigPageWebhookSetup/adyenConfigPageWebhookSetup.js`
- [Site setup](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenConfigPageSiteEndpoint/adyenConfigPageSiteEndpoint.js): `force-app/main/default/lwc/adyenConfigPageSiteEndpoint/adyenConfigPageSiteEndpoint.js`
- [Layout setup](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenConfigPageLayoutSetup/adyenConfigPageLayoutSetup.js): `force-app/main/default/lwc/adyenConfigPageLayoutSetup/adyenConfigPageLayoutSetup.js`
- [Permission setup](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenConfigPagePermissionSetup/adyenConfigPagePermissionSetup.js): `force-app/main/default/lwc/adyenConfigPagePermissionSetup/adyenConfigPagePermissionSetup.js`
- [Setup controller](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenConfigPageController.cls): `force-app/main/default/classes/AdyenConfigPageController.cls`
- [Merchant controller](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenMerchantAccountController.cls): `force-app/main/default/classes/AdyenMerchantAccountController.cls`
- [Webhook setup controller](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenWebhookSetupController.cls): `force-app/main/default/classes/AdyenWebhookSetupController.cls`
- [Management API client](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenManagementAPIService.cls): `force-app/main/default/classes/AdyenManagementAPIService.cls`

### Payment processing

- [OMS gateway adapter](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenGatewayAdapter.cls): `force-app/main/default/classes/AdyenGatewayAdapter.cls`
- [Payment operations](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenPaymentHelper.cls): `force-app/main/default/classes/AdyenPaymentHelper.cls`
- [Authorization handling](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenAuthorisationHelper.cls): `force-app/main/default/classes/AdyenAuthorisationHelper.cls`
- [Capture handling](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenCaptureHelper.cls): `force-app/main/default/classes/AdyenCaptureHelper.cls`
- [Refund handling](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenRefundHelper.cls): `force-app/main/default/classes/AdyenRefundHelper.cls`
- [Salesforce payment records](https://github.com/adyen/adyen-salesforce-oms/tree/main/force-app/main/default/objects/Payment): `force-app/main/default/objects/Payment`
- [OMS order events](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/OrderSummaryCreatedEventHandler.cls): `force-app/main/default/classes/OrderSummaryCreatedEventHandler.cls`

### Webhook handling

- [Notification handler](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenWebhookNotificationHandler.cls): `force-app/main/default/classes/AdyenWebhookNotificationHandler.cls`
- [Webhook service](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenWebhookService.cls): `force-app/main/default/classes/AdyenWebhookService.cls`
- [Event handlers](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenNotificationHandler.cls): `force-app/main/default/classes/AdyenNotificationHandler.cls`
- [Deployment result event](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/objects/Adyen_Metadata_Deployment_Result__e/Adyen_Metadata_Deployment_Result__e.object-meta.xml): `force-app/main/default/objects/Adyen_Metadata_Deployment_Result__e/Adyen_Metadata_Deployment_Result__e.object-meta.xml`

### Payment links

- [Payment link actions](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/PaymentLinkGenerateAction.cls): `force-app/main/default/classes/PaymentLinkGenerateAction.cls`
- [Payment link controller](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenOOBOController.cls): `force-app/main/default/classes/AdyenOOBOController.cls`
- [Payment link jobs](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/classes/AdyenPaymentLinkBatch.cls): `force-app/main/default/classes/AdyenPaymentLinkBatch.cls`
- [Payment link records](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/objects/Payment_Link__c/Payment_Link__c.object-meta.xml): `force-app/main/default/objects/Payment_Link__c/Payment_Link__c.object-meta.xml`
- [Choose payment](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/choosePayment/choosePayment.js): `force-app/main/default/lwc/choosePayment/choosePayment.js`
- [Link confirmation](https://github.com/adyen/adyen-salesforce-oms/blob/main/force-app/main/default/lwc/adyenPblConfirmationScreen/adyenPblConfirmationScreen.js): `force-app/main/default/lwc/adyenPblConfirmationScreen/adyenPblConfirmationScreen.js`

### Other components

- **Salesforce admin**
- **Adyen Checkout API**
- **Shopper**

## Connections

- Salesforce admin → OMS setup wizard: configures
- OMS setup wizard → Gateway setup: steps through
- OMS setup wizard → Merchant setup: steps through
- OMS setup wizard → Webhook setup: steps through
- OMS setup wizard → Site setup: steps through
- OMS setup wizard → Layout setup: steps through
- OMS setup wizard → Permission setup: steps through
- Gateway setup → Setup controller: calls (evidence: `force-app/main/default/lwc/adyenConfigPagePaymentGateway/adyenConfigPagePaymentGateway.js`)
- Site setup → Setup controller: calls (evidence: `force-app/main/default/lwc/adyenConfigPageSiteEndpoint/adyenConfigPageSiteEndpoint.js`)
- Layout setup → Setup controller: calls (evidence: `force-app/main/default/lwc/adyenConfigPageLayoutSetup/adyenConfigPageLayoutSetup.js`)
- Permission setup → Setup controller: calls (evidence: `force-app/main/default/lwc/adyenConfigPagePermissionSetup/adyenConfigPagePermissionSetup.js`)
- Merchant setup → Merchant controller: calls (evidence: `force-app/main/default/lwc/adyenConfigPageMerchantAccount/adyenConfigPageMerchantAccount.js`)
- Merchant setup → Management API client: fetches accounts (evidence: `force-app/main/default/lwc/adyenConfigPageMerchantAccount/adyenConfigPageMerchantAccount.js`)
- Webhook setup → Webhook setup controller: calls (evidence: `force-app/main/default/lwc/adyenConfigPageWebhookSetup/adyenConfigPageWebhookSetup.js`)
- Webhook setup → Deployment result event: subscribes (evidence: `force-app/main/default/lwc/adyenConfigPageWebhookSetup/adyenConfigPageWebhookSetup.js`)
- OMS gateway adapter → Adyen Checkout API: sends payment requests
- OMS gateway adapter → Payment operations: delegates
- Payment operations → Authorization handling: delegates
- Payment operations → Capture handling: delegates
- Payment operations → Refund handling: delegates
- Payment operations → Salesforce payment records: updates
- Notification handler → Webhook service: delegates
- Notification handler → Event handlers: dispatches
- Webhook service → Adyen Checkout API: configures webhooks
- Shopper → Choose payment: selects mode
- Choose payment → Payment link controller: requests link
- Payment link actions → Payment link controller: invokes
- Payment link controller → Payment link records: creates or updates
- Payment link jobs → Payment link records: processes
- Payment link controller → Link confirmation: returns link details
- Link confirmation → Payment link controller: looks up order (evidence: `force-app/main/default/lwc/adyenPblConfirmationScreen/adyenPblConfirmationScreen.js`)
- OMS order events → Payment link controller: triggers link flow
- OMS gateway adapter → OMS order events: supports OMS orders
