# atoapaymentslimited/atoawebclientsdk architecture

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

- Interactive diagram: https://gitdiagram.com/atoapaymentslimited/atoawebclientsdk
- Repository: https://github.com/atoapaymentslimited/atoawebclientsdk

## Overview

Atoa Web Client SDK embeds a payment dialog in a merchant’s web application. The principal flow is: the merchant configures and opens the SDK, the dialog fetches payment and bank data, the customer chooses bank or card, and the UI supports authorization and payment-status handling. The graph preserves the documented returning-customer, card, and status capabilities. Source excerpts show the dialog, service, HTTP client, and key UI wiring; other component links use SOURCE INDEX references. Unsampled internal behavior is not inferred.

Main entry points: [`src/components/rightPane/RightPane.vue`](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/RightPane.vue) (Payment flow), [`src/core/services/PaymentsService.ts`](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/core/services/PaymentsService.ts) (Payments service), [`src/components/PaymentDialog.vue`](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/PaymentDialog.vue) (Payment dialog), [`src/components/rightPane/selectBank/SelectBank.vue`](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/selectBank/SelectBank.vue) (Bank selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sdk["SDK entry"]
  node_sdk_api["SDK API<br/>[index.ts]"]
  node_dialog_mount["Dialog host<br/>[dialog.vue]"]
end

subgraph group_dialog["Payment dialog"]
  node_payment_dialog["Payment dialog<br/>[PaymentDialog.vue]"]
  node_left_pane["Payment summary<br/>[LeftPane.vue]"]
end

subgraph group_payment_ui["Payment experience"]
  node_right_pane["Payment flow<br/>[RightPane.vue]"]
  node_bank_picker["Bank selection<br/>[SelectBank.vue]"]
  node_bank_grid["Bank grid<br/>[BanksGrid.vue]"]
  node_bank_tabs["Bank tabs<br/>[BankTabs.vue]"]
  node_explainer["Bank explainer<br/>[ExplainerUI.vue]"]
  node_payment_options["Bank payment<br/>[PaymentOptions.vue]"]
  node_verification["Payment verification"]
  node_payment_status["Payment status<br/>[PaymentStatus.vue]"]
  node_payment_details_ui["Status details"]
  node_card_checkout["Card checkout<br/>[CardCheckout.vue]"]
  node_card_simulator["Mock card flow"]
  node_mock_3ds["Mock 3DS<br/>[Mock3ds.vue]"]
end

subgraph group_services["Payment services"]
  node_payments_service["Payments service<br/>[PaymentsService.ts]"]
  node_simulator_service["Simulator service"]
  node_http_client["HTTP client<br/>[http-client.ts]"]
  node_http_utils["API utilities<br/>[http-utils.ts]"]
end

node_merchant(("Merchant app"))
node_atoa_api(("Atoa payment APIs"))
node_rapyd(("Rapyd checkout"))

node_merchant -->|"configures"| node_sdk_api
node_sdk_api -->|"opens dialog"| node_dialog_mount
node_dialog_mount -->|"renders"| node_payment_dialog
node_payment_dialog -->|"renders"| node_left_pane
node_payment_dialog -->|"renders"| node_right_pane
node_payment_dialog -->|"fetches details"| node_payments_service
node_payments_service -->|"makes requests"| node_http_client
node_payments_service -->|"wraps calls"| node_http_utils
node_http_client -->|"sends requests"| node_atoa_api
node_right_pane -->|"renders"| node_bank_picker
node_right_pane -->|"renders"| node_explainer
node_right_pane -->|"renders"| node_payment_options
node_right_pane -->|"renders"| node_verification
node_right_pane -->|"renders"| node_payment_status
node_right_pane -->|"renders"| node_card_checkout
node_bank_picker -->|"uses"| node_bank_grid
node_bank_picker -->|"uses"| node_bank_tabs
node_bank_picker -->|"loads banks"| node_payments_service
node_payment_options -->|"requests payment"| node_payments_service
node_payment_status -->|"renders details"| node_payment_details_ui
node_payment_status -->|"checks status"| node_payments_service
node_card_checkout -->|"authorizes card"| node_payments_service
node_card_checkout -->|"loads checkout"| node_rapyd
node_card_checkout -->|"mounts simulator"| node_card_simulator
node_card_simulator -->|"uses"| node_mock_3ds
node_card_simulator -->|"calls"| node_simulator_service
node_simulator_service -->|"makes requests"| node_http_client
node_simulator_service -->|"wraps calls"| node_http_utils
node_payment_dialog -->|"loads bank data"| node_atoa_api

click node_sdk_api "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/index.ts"
click node_dialog_mount "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/dialog.vue"
click node_payment_dialog "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/PaymentDialog.vue"
click node_left_pane "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/leftPane/LeftPane.vue"
click node_right_pane "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/RightPane.vue"
click node_bank_picker "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/selectBank/SelectBank.vue"
click node_bank_grid "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/selectBank/BanksGrid.vue"
click node_bank_tabs "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/selectBank/BankTabs.vue"
click node_explainer "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/explainer/ExplainerUI.vue"
click node_payment_options "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/paymentOptions/PaymentOptions.vue"
click node_verification "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/paymentVerification/PaymentVerification.vue"
click node_payment_status "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/paymentStatus/PaymentStatus.vue"
click node_payment_details_ui "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/paymentDetails/PaymentDetailsUI.vue"
click node_card_checkout "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/cardCheckout/CardCheckout.vue"
click node_card_simulator "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/cardCheckout/MockCardSimulator.vue"
click node_mock_3ds "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/cardCheckout/Mock3ds.vue"
click node_payments_service "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/core/services/PaymentsService.ts"
click node_simulator_service "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/core/services/MockCardSimulatorService.ts"
click node_http_client "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/core/utils/http-client.ts"
click node_http_utils "https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/core/utils/http-utils.ts"

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_sdk_api,node_dialog_mount toneBlue
class node_payment_dialog,node_left_pane toneAmber
class node_right_pane,node_bank_picker,node_bank_grid,node_bank_tabs,node_explainer,node_payment_options,node_verification,node_payment_status,node_payment_details_ui,node_card_checkout,node_card_simulator,node_mock_3ds,node_atoa_api toneMint
class node_payments_service,node_simulator_service,node_http_client,node_http_utils toneRose
class node_merchant,node_rapyd toneIndigo
```

## Components

### SDK entry

- [SDK API](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/index.ts): `src/index.ts`
- [Dialog host](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/dialog.vue): `src/dialog.vue`

### Payment dialog

- [Payment dialog](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/PaymentDialog.vue): `src/components/PaymentDialog.vue`
- [Payment summary](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/leftPane/LeftPane.vue): `src/components/leftPane/LeftPane.vue`

### Payment experience

- [Payment flow](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/RightPane.vue): `src/components/rightPane/RightPane.vue`
- [Bank selection](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/selectBank/SelectBank.vue): `src/components/rightPane/selectBank/SelectBank.vue`
- [Bank grid](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/selectBank/BanksGrid.vue): `src/components/rightPane/selectBank/BanksGrid.vue`
- [Bank tabs](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/selectBank/BankTabs.vue): `src/components/rightPane/selectBank/BankTabs.vue`
- [Bank explainer](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/explainer/ExplainerUI.vue): `src/components/rightPane/explainer/ExplainerUI.vue`
- [Bank payment](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/paymentOptions/PaymentOptions.vue): `src/components/rightPane/paymentOptions/PaymentOptions.vue`
- [Payment verification](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/paymentVerification/PaymentVerification.vue): `src/components/rightPane/paymentVerification/PaymentVerification.vue`
- [Payment status](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/paymentStatus/PaymentStatus.vue): `src/components/rightPane/paymentStatus/PaymentStatus.vue`
- [Status details](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/paymentDetails/PaymentDetailsUI.vue): `src/components/rightPane/paymentDetails/PaymentDetailsUI.vue`
- [Card checkout](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/cardCheckout/CardCheckout.vue): `src/components/rightPane/cardCheckout/CardCheckout.vue`
- [Mock card flow](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/cardCheckout/MockCardSimulator.vue): `src/components/rightPane/cardCheckout/MockCardSimulator.vue`
- [Mock 3DS](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/components/rightPane/cardCheckout/Mock3ds.vue): `src/components/rightPane/cardCheckout/Mock3ds.vue`

### Payment services

- [Payments service](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/core/services/PaymentsService.ts): `src/core/services/PaymentsService.ts`
- [Simulator service](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/core/services/MockCardSimulatorService.ts): `src/core/services/MockCardSimulatorService.ts`
- [HTTP client](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/core/utils/http-client.ts): `src/core/utils/http-client.ts`
- [API utilities](https://github.com/atoapaymentslimited/atoawebclientsdk/blob/main/src/core/utils/http-utils.ts): `src/core/utils/http-utils.ts`

### Other components

- **Merchant app**
- **Atoa payment APIs**
- **Rapyd checkout**

## Connections

- Merchant app → SDK API: configures
- SDK API → Dialog host: opens dialog (evidence: `src/index.ts`)
- Dialog host → Payment dialog: renders (evidence: `src/dialog.vue`)
- Payment dialog → Payment summary: renders (evidence: `src/components/PaymentDialog.vue`)
- Payment dialog → Payment flow: renders (evidence: `src/components/PaymentDialog.vue`)
- Payment dialog → Payments service: fetches details (evidence: `src/components/PaymentDialog.vue`)
- Payments service → HTTP client: makes requests (evidence: `src/core/services/PaymentsService.ts`)
- Payments service → API utilities: wraps calls (evidence: `src/core/services/PaymentsService.ts`)
- HTTP client → Atoa payment APIs: sends requests (evidence: `src/core/utils/http-client.ts`)
- Payment flow → Bank selection: renders (evidence: `src/components/rightPane/RightPane.vue`)
- Payment flow → Bank explainer: renders (evidence: `src/components/rightPane/RightPane.vue`)
- Payment flow → Bank payment: renders (evidence: `src/components/rightPane/RightPane.vue`)
- Payment flow → Payment verification: renders (evidence: `src/components/rightPane/RightPane.vue`)
- Payment flow → Payment status: renders (evidence: `src/components/rightPane/RightPane.vue`)
- Payment flow → Card checkout: renders (evidence: `src/components/rightPane/RightPane.vue`)
- Bank selection → Bank grid: uses (evidence: `src/components/rightPane/selectBank/SelectBank.vue`)
- Bank selection → Bank tabs: uses (evidence: `src/components/rightPane/selectBank/SelectBank.vue`)
- Bank selection → Payments service: loads banks (evidence: `src/components/rightPane/selectBank/SelectBank.vue`)
- Bank payment → Payments service: requests payment (evidence: `src/components/rightPane/paymentOptions/PaymentOptions.vue`)
- Payment status → Status details: renders details (evidence: `src/components/rightPane/paymentStatus/PaymentStatus.vue`)
- Payment status → Payments service: checks status (evidence: `src/components/rightPane/paymentStatus/PaymentStatus.vue`)
- Card checkout → Payments service: authorizes card (evidence: `src/components/rightPane/cardCheckout/CardCheckout.vue`)
- Card checkout → Rapyd checkout: loads checkout (evidence: `src/components/rightPane/cardCheckout/CardCheckout.vue`)
- Card checkout → Mock card flow: mounts simulator (evidence: `src/components/rightPane/cardCheckout/CardCheckout.vue`)
- Mock card flow → Mock 3DS: uses (evidence: `src/components/rightPane/cardCheckout/MockCardSimulator.vue`)
- Mock card flow → Simulator service: calls (evidence: `src/components/rightPane/cardCheckout/MockCardSimulator.vue`)
- Simulator service → HTTP client: makes requests (evidence: `src/core/services/MockCardSimulatorService.ts`)
- Simulator service → API utilities: wraps calls (evidence: `src/core/services/MockCardSimulatorService.ts`)
- Payment dialog → Atoa payment APIs: loads bank data (evidence: `src/components/PaymentDialog.vue`)
