# adyen/adyen-dotnet-api-library architecture

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

- Interactive diagram: https://gitdiagram.com/adyen/adyen-dotnet-api-library
- Repository: https://github.com/adyen/adyen-dotnet-api-library

## Overview

Adyen’s .NET API library lets application code call Adyen payment, platform, account-management, and related APIs, then consume typed responses; it also includes webhook handlers for inbound notifications. The main workflow is application → API-specific service → shared HTTP client → Adyen API → response. Groups distinguish API domains and shared runtime infrastructure. The README documents the supported API families; sampled generated services show request construction and response handling. Several capabilities are represented at their documented directory level because their implementation was not sampled.

Main entry points: [`Adyen/TerminalApi/Client.cs`](https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/TerminalApi/Client.cs) (Terminal API), [`Adyen/BalancePlatform`](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/BalancePlatform) (Balance platform), [`Adyen/Checkout`](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Checkout) (Checkout), [`Adyen/Payment`](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Payment) (Payments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_payments["Payments"]
  node_checkout["Checkout"]
  node_payments_api["Payments"]
  node_recurring["Recurring"]
  node_payout["Payouts"]
  node_stored_value["Stored value"]
  node_terminal["Terminal API<br/>[Client.cs]"]
end

subgraph group_platform["Platforms"]
  node_balance_platform["Balance platform"]
  node_balance_control["Balance control"]
  node_capital["Capital"]
  node_transfers["Transfers"]
end

subgraph group_business["Business APIs"]
  node_legal["Legal entities"]
  node_management["Management"]
  node_disputes["Disputes"]
  node_bin_lookup["BIN lookup"]
  node_data_protection["Data protection"]
end

subgraph group_webhooks["Webhooks"]
  node_webhook_handlers["Webhook handlers<br/>[WebhookHandler.cs]"]
  node_balance_webhooks["Balance notifications"]
  node_transfer_webhooks["Transfer notifications"]
end

subgraph group_runtime["Shared runtime"]
  node_core_response["API responses<br/>[ApiResponse.cs]"]
  node_core_url["URL construction"]
  node_option["Optional parameters<br/>[Option.cs]"]
end

node_app(("Application"))
node_adyen(("Adyen APIs"))

node_app -->|"calls"| node_checkout
node_app -->|"calls"| node_payments_api
node_app -->|"calls"| node_recurring
node_app -->|"calls"| node_payout
node_app -->|"calls"| node_stored_value
node_app -->|"calls"| node_balance_platform
node_app -->|"calls"| node_balance_control
node_app -->|"calls"| node_capital
node_app -->|"calls"| node_transfers
node_app -->|"calls"| node_legal
node_app -->|"calls"| node_management
node_app -->|"calls"| node_disputes
node_app -->|"calls"| node_bin_lookup
node_app -->|"calls"| node_data_protection
node_checkout -.->|"uses client"| node_terminal
node_payments_api -.->|"uses client"| node_terminal
node_recurring -->|"uses client"| node_terminal
node_payout -->|"uses client"| node_terminal
node_stored_value -->|"uses client"| node_terminal
node_balance_platform -->|"uses client"| node_terminal
node_balance_control -.->|"uses client"| node_terminal
node_capital -.->|"uses client"| node_terminal
node_transfers -->|"uses client"| node_terminal
node_legal -->|"uses client"| node_terminal
node_management -->|"uses client"| node_terminal
node_disputes -.->|"uses client"| node_terminal
node_bin_lookup -.->|"uses client"| node_terminal
node_data_protection -.->|"uses client"| node_terminal
node_terminal -.->|"sends requests"| node_adyen
node_adyen -.->|"returns HTTP data"| node_core_response
node_balance_webhooks -.->|"delivers notification"| node_app
node_transfer_webhooks -.->|"delivers notification"| node_app
node_webhook_handlers -.->|"handles notifications"| node_app
node_balance_platform -->|"models optional fields"| node_option
node_terminal -.->|"configures endpoints"| node_core_url

click node_checkout "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Checkout"
click node_payments_api "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Payment"
click node_recurring "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Recurring"
click node_payout "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Payout"
click node_stored_value "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/StoredValue"
click node_balance_platform "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/BalancePlatform"
click node_balance_control "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/BalanceControl"
click node_capital "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Capital"
click node_transfers "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Transfers"
click node_legal "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/LegalEntityManagement"
click node_management "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Management"
click node_disputes "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Disputes"
click node_bin_lookup "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/BinLookup"
click node_data_protection "https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/DataProtection"
click node_terminal "https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/TerminalApi/Client.cs"
click node_webhook_handlers "https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/Webhooks/WebhookHandler.cs"
click node_balance_webhooks "https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/BalanceWebhooks/Handlers/BalanceWebhooksHandler.cs"
click node_transfer_webhooks "https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/TransferWebhooks/Handlers/TransferWebhooksHandler.cs"
click node_core_response "https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/Core/Client/ApiResponse.cs"
click node_core_url "https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/Core/Client/UrlBuilderExtensions.cs"
click node_option "https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/Core/Option.cs"

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,node_payments_api,node_recurring,node_payout,node_stored_value,node_terminal toneBlue
class node_balance_platform,node_balance_control,node_capital,node_transfers toneAmber
class node_legal,node_management,node_disputes,node_bin_lookup,node_data_protection,node_adyen toneMint
class node_webhook_handlers,node_balance_webhooks,node_transfer_webhooks toneRose
class node_core_response,node_core_url,node_option,node_app toneIndigo
```

## Components

### Payments

- [Checkout](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Checkout): `Adyen/Checkout`
- [Payments](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Payment): `Adyen/Payment`
- [Recurring](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Recurring): `Adyen/Recurring`
- [Payouts](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Payout): `Adyen/Payout`
- [Stored value](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/StoredValue): `Adyen/StoredValue`
- [Terminal API](https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/TerminalApi/Client.cs): `Adyen/TerminalApi/Client.cs`

### Platforms

- [Balance platform](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/BalancePlatform): `Adyen/BalancePlatform`
- [Balance control](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/BalanceControl): `Adyen/BalanceControl`
- [Capital](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Capital): `Adyen/Capital`
- [Transfers](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Transfers): `Adyen/Transfers`

### Business APIs

- [Legal entities](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/LegalEntityManagement): `Adyen/LegalEntityManagement`
- [Management](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Management): `Adyen/Management`
- [Disputes](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/Disputes): `Adyen/Disputes`
- [BIN lookup](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/BinLookup): `Adyen/BinLookup`
- [Data protection](https://github.com/adyen/adyen-dotnet-api-library/tree/main/Adyen/DataProtection): `Adyen/DataProtection`

### Webhooks

- [Webhook handlers](https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/Webhooks/WebhookHandler.cs): `Adyen/Webhooks/WebhookHandler.cs`
- [Balance notifications](https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/BalanceWebhooks/Handlers/BalanceWebhooksHandler.cs): `Adyen/BalanceWebhooks/Handlers/BalanceWebhooksHandler.cs`
- [Transfer notifications](https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/TransferWebhooks/Handlers/TransferWebhooksHandler.cs): `Adyen/TransferWebhooks/Handlers/TransferWebhooksHandler.cs`

### Shared runtime

- [API responses](https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/Core/Client/ApiResponse.cs): `Adyen/Core/Client/ApiResponse.cs`
- [URL construction](https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/Core/Client/UrlBuilderExtensions.cs): `Adyen/Core/Client/UrlBuilderExtensions.cs`
- [Optional parameters](https://github.com/adyen/adyen-dotnet-api-library/blob/main/Adyen/Core/Option.cs): `Adyen/Core/Option.cs`

### Other components

- **Application**
- **Adyen APIs**

## Connections

- Application → Checkout: calls (evidence: `README.md`)
- Application → Payments: calls (evidence: `README.md`)
- Application → Recurring: calls (evidence: `README.md`)
- Application → Payouts: calls (evidence: `README.md`)
- Application → Stored value: calls (evidence: `README.md`)
- Application → Balance platform: calls (evidence: `README.md`)
- Application → Balance control: calls (evidence: `README.md`)
- Application → Capital: calls (evidence: `README.md`)
- Application → Transfers: calls (evidence: `README.md`)
- Application → Legal entities: calls (evidence: `README.md`)
- Application → Management: calls (evidence: `README.md`)
- Application → Disputes: calls (evidence: `README.md`)
- Application → BIN lookup: calls (evidence: `README.md`)
- Application → Data protection: calls (evidence: `README.md`)
- Checkout → Terminal API: uses client (evidence: `Adyen/Checkout/Models/CheckoutSessionInstallmentOption.cs`)
- Payments → Terminal API: uses client (evidence: `Adyen/Payment/Services/ModificationsService.cs`)
- Recurring → Terminal API: uses client (evidence: `Adyen/Recurring/Services/RecurringService.cs`)
- Payouts → Terminal API: uses client (evidence: `Adyen/Payout/Services/ReviewingService.cs`)
- Stored value → Terminal API: uses client (evidence: `Adyen/StoredValue/Services/StoredValueService.cs`)
- Balance platform → Terminal API: uses client (evidence: `Adyen/BalancePlatform/Services/AuthorizedCardUsersService.cs`)
- Balance control → Terminal API: uses client
- Capital → Terminal API: uses client (evidence: `Adyen/Capital/Services/GrantsService.cs`)
- Transfers → Terminal API: uses client (evidence: `Adyen/Transfers/Services/TransfersService.cs`)
- Legal entities → Terminal API: uses client (evidence: `Adyen/LegalEntityManagement/Services/LegalEntitiesService.cs`)
- Management → Terminal API: uses client (evidence: `Adyen/Management/Services/TerminalOrdersCompanyLevelService.cs`)
- Disputes → Terminal API: uses client (evidence: `Adyen/Disputes/Services/DisputesService.cs`)
- BIN lookup → Terminal API: uses client (evidence: `Adyen/BinLookup/Services/BinLookupService.cs`)
- Data protection → Terminal API: uses client (evidence: `Adyen/DataProtection/Services/DataProtectionService.cs`)
- Terminal API → Adyen APIs: sends requests
- Adyen APIs → API responses: returns HTTP data
- Balance notifications → Application: delivers notification
- Transfer notifications → Application: delivers notification
- Webhook handlers → Application: handles notifications
- Balance platform → Optional parameters: models optional fields (evidence: `Adyen/BalancePlatform/Models/BalancePlatform.cs`)
- Terminal API → URL construction: configures endpoints (evidence: `Adyen/Core/Client/UrlBuilderExtensions.cs`)
