# govuk-pay/pay-product-page architecture

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

- Interactive diagram: https://gitdiagram.com/govuk-pay/pay-product-page
- Repository: https://github.com/govuk-pay/pay-product-page

## Overview

This repository is the GOV.UK Pay public product-pages site: users read product information about payment features, setup, security, support and related topics. Its browser runtime initializes GOV.UK components, cookie consent controls and analytics. The excerpts show the JavaScript call relationships; the individual page templates and shared layout were not sampled, so their rendering and navigation links are not inferred.

Main entry points: [`source/javascripts/application.js`](https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/application.js) (Browser initializer), [`source/javascripts/cookie-banner/cookie-banner.js`](https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/cookie-banner/cookie-banner.js) (Cookie banner), [`source/javascripts/analytics/init.js`](https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/analytics/init.js) (Analytics initializer), [`source/javascripts/cookie-settings/cookie-settings.js`](https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/cookie-settings/cookie-settings.js) (Cookie settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["Product information"]
  node_home["Product overview<br/>[index.html.erb]"]
  node_using["Using GOV.UK Pay"]
end

subgraph group_features["Payment features"]
  node_pages["Payment pages"]
  node_api["API integration"]
  node_recurring["Recurring payments"]
  node_directdebit["Direct Debit"]
  node_wallets["Digital wallets"]
  node_phonepost["Phone and post"]
  node_provider["Payment provider"]
end

subgraph group_guidance["Guidance and support"]
  node_security["Security<br/>[security.html.erb]"]
  node_privacy["Privacy and cookies<br/>[privacy.html.erb]"]
  node_cookiespage["Cookie information<br/>[cookies.html.erb]"]
  node_support["Support<br/>[support.html.erb]"]
end

subgraph group_browser["Browser behavior"]
  node_app["Browser initializer<br/>[application.js]"]
  node_banner["Cookie banner<br/>[cookie-banner.js]"]
  node_settings["Cookie settings<br/>[cookie-settings.js]"]
  node_cookie["Consent and cookie utilities"]
  node_analyticsinit["Analytics initializer<br/>[init.js]"]
  node_analytics["Analytics loader<br/>[analytics.js]"]
end

node_visitor(("Site visitor"))
node_ga["Google Analytics"]

node_visitor -->|"reads"| node_home
node_app -->|"initializes"| node_banner
node_app -->|"initializes"| node_settings
node_app -->|"initializes"| node_analyticsinit
node_banner -->|"reads and sets"| node_cookie
node_banner -->|"initializes"| node_analyticsinit
node_settings -->|"reads and sets"| node_cookie
node_analyticsinit -->|"calls"| node_analytics
node_analytics -->|"loads script"| node_ga

click node_home "https://github.com/govuk-pay/pay-product-page/blob/main/source/index.html.erb"
click node_using "https://github.com/govuk-pay/pay-product-page/blob/main/source/using-govuk-pay.html.erb"
click node_pages "https://github.com/govuk-pay/pay-product-page/blob/main/source/govuk-payment-pages.html.erb"
click node_api "https://github.com/govuk-pay/pay-product-page/blob/main/source/api-integration.html.erb"
click node_recurring "https://github.com/govuk-pay/pay-product-page/blob/main/source/recurring-payments.html.erb"
click node_directdebit "https://github.com/govuk-pay/pay-product-page/blob/main/source/direct-debit.html.erb"
click node_wallets "https://github.com/govuk-pay/pay-product-page/blob/main/source/apple-pay-and-google-pay.html.erb"
click node_phonepost "https://github.com/govuk-pay/pay-product-page/blob/main/source/take-payments-by-phone-or-post.html.erb"
click node_provider "https://github.com/govuk-pay/pay-product-page/blob/main/source/payment-service-provider.html.erb"
click node_security "https://github.com/govuk-pay/pay-product-page/blob/main/source/security.html.erb"
click node_privacy "https://github.com/govuk-pay/pay-product-page/blob/main/source/privacy.html.erb"
click node_cookiespage "https://github.com/govuk-pay/pay-product-page/blob/main/source/cookies.html.erb"
click node_support "https://github.com/govuk-pay/pay-product-page/blob/main/source/support.html.erb"
click node_app "https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/application.js"
click node_banner "https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/cookie-banner/cookie-banner.js"
click node_settings "https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/cookie-settings/cookie-settings.js"
click node_cookie "https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/helpers/cookie/cookie-functions.js"
click node_analyticsinit "https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/analytics/init.js"
click node_analytics "https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/analytics/analytics.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_home,node_using toneBlue
class node_pages,node_api,node_recurring,node_directdebit,node_wallets,node_phonepost,node_provider toneAmber
class node_security,node_privacy,node_cookiespage,node_support toneMint
class node_app,node_banner,node_settings,node_cookie,node_analyticsinit,node_analytics toneRose
class node_visitor,node_ga toneIndigo
```

## Components

### Product information

- [Product overview](https://github.com/govuk-pay/pay-product-page/blob/main/source/index.html.erb): `source/index.html.erb`
- [Using GOV.UK Pay](https://github.com/govuk-pay/pay-product-page/blob/main/source/using-govuk-pay.html.erb): `source/using-govuk-pay.html.erb`

### Payment features

- [Payment pages](https://github.com/govuk-pay/pay-product-page/blob/main/source/govuk-payment-pages.html.erb): `source/govuk-payment-pages.html.erb`
- [API integration](https://github.com/govuk-pay/pay-product-page/blob/main/source/api-integration.html.erb): `source/api-integration.html.erb`
- [Recurring payments](https://github.com/govuk-pay/pay-product-page/blob/main/source/recurring-payments.html.erb): `source/recurring-payments.html.erb`
- [Direct Debit](https://github.com/govuk-pay/pay-product-page/blob/main/source/direct-debit.html.erb): `source/direct-debit.html.erb`
- [Digital wallets](https://github.com/govuk-pay/pay-product-page/blob/main/source/apple-pay-and-google-pay.html.erb): `source/apple-pay-and-google-pay.html.erb`
- [Phone and post](https://github.com/govuk-pay/pay-product-page/blob/main/source/take-payments-by-phone-or-post.html.erb): `source/take-payments-by-phone-or-post.html.erb`
- [Payment provider](https://github.com/govuk-pay/pay-product-page/blob/main/source/payment-service-provider.html.erb): `source/payment-service-provider.html.erb`

### Guidance and support

- [Security](https://github.com/govuk-pay/pay-product-page/blob/main/source/security.html.erb): `source/security.html.erb`
- [Privacy and cookies](https://github.com/govuk-pay/pay-product-page/blob/main/source/privacy.html.erb): `source/privacy.html.erb`
- [Cookie information](https://github.com/govuk-pay/pay-product-page/blob/main/source/cookies.html.erb): `source/cookies.html.erb`
- [Support](https://github.com/govuk-pay/pay-product-page/blob/main/source/support.html.erb): `source/support.html.erb`

### Browser behavior

- [Browser initializer](https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/application.js): `source/javascripts/application.js`
- [Cookie banner](https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/cookie-banner/cookie-banner.js): `source/javascripts/cookie-banner/cookie-banner.js`
- [Cookie settings](https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/cookie-settings/cookie-settings.js): `source/javascripts/cookie-settings/cookie-settings.js`
- [Consent and cookie utilities](https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/helpers/cookie/cookie-functions.js): `source/javascripts/helpers/cookie/cookie-functions.js`
- [Analytics initializer](https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/analytics/init.js): `source/javascripts/analytics/init.js`
- [Analytics loader](https://github.com/govuk-pay/pay-product-page/blob/main/source/javascripts/analytics/analytics.js): `source/javascripts/analytics/analytics.js`

### Other components

- **Site visitor**
- **Google Analytics**

## Connections

- Site visitor → Product overview: reads (evidence: `README.md`)
- Browser initializer → Cookie banner: initializes (evidence: `source/javascripts/application.js`)
- Browser initializer → Cookie settings: initializes (evidence: `source/javascripts/application.js`)
- Browser initializer → Analytics initializer: initializes (evidence: `source/javascripts/application.js`)
- Cookie banner → Consent and cookie utilities: reads and sets (evidence: `source/javascripts/cookie-banner/cookie-banner.js`)
- Cookie banner → Analytics initializer: initializes (evidence: `source/javascripts/cookie-banner/cookie-banner.js`)
- Cookie settings → Consent and cookie utilities: reads and sets (evidence: `source/javascripts/cookie-settings/cookie-settings.js`)
- Analytics initializer → Analytics loader: calls (evidence: `source/javascripts/analytics/init.js`)
- Analytics loader → Google Analytics: loads script (evidence: `source/javascripts/analytics/analytics.js`)
