# stripe/stripe-dotnet architecture

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

- Interactive diagram: https://gitdiagram.com/stripe/stripe-dotnet
- Repository: https://github.com/stripe/stripe-dotnet

## Overview

Stripe.net is the official .NET SDK for Stripe’s API. A developer configures a StripeClient, selects a versioned service, and invokes resource operations; the service delegates requests through the shared request pipeline and returns typed entities. The README documents CRUD, pagination, per-request configuration, retries, and custom HTTP clients. Sampled files show client, service, requestor, and transport responsibilities; domain services and serialization are represented at the supported module level because most implementations were not sampled.

Main entry points: [`src/Stripe.net/Services/_base/Service.cs`](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/_base/Service.cs) (Service base), [`src/Stripe.net/Infrastructure/Public/ApiRequestor.cs`](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/Public/ApiRequestor.cs) (API requestor), [`src/Stripe.net/Entities/_base/StripeEntity.cs`](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Entities/_base/StripeEntity.cs) (Entity base), [`src/Stripe.net/Infrastructure/Public/StripeClient.cs`](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/Public/StripeClient.cs) (StripeClient)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Client entry"]
  node_client["StripeClient<br/>[StripeClient.cs]"]
  node_options["Request options<br/>[RequestOptions.cs]"]
end

subgraph group_domains["API services"]
  node_v1["V1 services<br/>[V1Services.cs]"]
  node_identity["Identity sessions"]
  node_issuing["Issuing authorizations"]
  node_reviews["Reviews<br/>[ReviewService.cs]"]
  node_sigma["Sigma queries"]
  node_three_ds["3DS authentications"]
end

subgraph group_pipeline["Request pipeline"]
  node_service_base["Service base<br/>[Service.cs]"]
  node_api_requestor["API requestor<br/>[ApiRequestor.cs]"]
  node_http_client["HTTP transport"]
end

subgraph group_models["Typed models"]
  node_entity["Entity base<br/>[StripeEntity.cs]"]
  node_json["JSON converters"]
  node_unix_json["Date converters"]
  node_unix_json_legacy["Legacy date converter"]
  node_forward_request["Forwarding request<br/>[Request.cs]"]
end

node_developer(("SDK user"))
node_stripe_api{{"Stripe API"}}

node_developer -->|"configures"| node_client
node_developer -->|"calls operations"| node_v1
node_client -->|"exposes"| node_v1
node_client -->|"delegates requests"| node_api_requestor
node_v1 -.->|"provides service"| node_identity
node_identity -->|"uses"| node_service_base
node_issuing -->|"uses"| node_service_base
node_reviews -->|"uses"| node_service_base
node_sigma -->|"uses"| node_service_base
node_three_ds -->|"uses"| node_service_base
node_service_base -->|"sends requests"| node_api_requestor
node_api_requestor -.->|"uses transport"| node_http_client
node_api_requestor -->|"requests data"| node_stripe_api
node_options -->|"configures requests"| node_client
node_api_requestor -.->|"returns typed data"| node_entity
node_json -.->|"converts"| node_entity
node_unix_json -.->|"converts dates"| node_entity
node_unix_json_legacy -.->|"converts dates"| node_entity
node_forward_request -.->|"extends"| node_entity

click node_client "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/Public/StripeClient.cs"
click node_options "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/_common/RequestOptions.cs"
click node_v1 "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/V1Services.cs"
click node_identity "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/Identity/VerificationSessions/VerificationSessionService.cs"
click node_issuing "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/Issuing/Authorizations/AuthorizationService.cs"
click node_reviews "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/Reviews/ReviewService.cs"
click node_sigma "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/Sigma/ScheduledQueryRuns/ScheduledQueryRunService.cs"
click node_three_ds "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/ThreeDSecure/Authentications/AuthenticationService.cs"
click node_service_base "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/_base/Service.cs"
click node_api_requestor "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/Public/ApiRequestor.cs"
click node_http_client "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/Public/SystemNetHttpClient.cs"
click node_entity "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Entities/_base/StripeEntity.cs"
click node_json "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/JsonConverters/STJStripeEntityConverter.cs"
click node_unix_json "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/JsonConverters/STJUnixDateTimeConverter.cs"
click node_unix_json_legacy "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/JsonConverters/UnixDateTimeConverter.cs"
click node_forward_request "https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Entities/Forwarding/Requests/Request.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_client,node_options,node_developer toneBlue
class node_v1,node_identity,node_issuing,node_reviews,node_sigma,node_three_ds toneAmber
class node_service_base,node_api_requestor,node_http_client,node_stripe_api toneMint
class node_entity,node_json,node_unix_json,node_unix_json_legacy,node_forward_request toneRose
```

## Components

### Client entry

- [StripeClient](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/Public/StripeClient.cs): `src/Stripe.net/Infrastructure/Public/StripeClient.cs`
- [Request options](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/_common/RequestOptions.cs): `src/Stripe.net/Services/_common/RequestOptions.cs`

### API services

- [V1 services](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/V1Services.cs): `src/Stripe.net/Services/V1Services.cs`
- [Identity sessions](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/Identity/VerificationSessions/VerificationSessionService.cs): `src/Stripe.net/Services/Identity/VerificationSessions/VerificationSessionService.cs`
- [Issuing authorizations](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/Issuing/Authorizations/AuthorizationService.cs): `src/Stripe.net/Services/Issuing/Authorizations/AuthorizationService.cs`
- [Reviews](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/Reviews/ReviewService.cs): `src/Stripe.net/Services/Reviews/ReviewService.cs`
- [Sigma queries](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/Sigma/ScheduledQueryRuns/ScheduledQueryRunService.cs): `src/Stripe.net/Services/Sigma/ScheduledQueryRuns/ScheduledQueryRunService.cs`
- [3DS authentications](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/ThreeDSecure/Authentications/AuthenticationService.cs): `src/Stripe.net/Services/ThreeDSecure/Authentications/AuthenticationService.cs`

### Request pipeline

- [Service base](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Services/_base/Service.cs): `src/Stripe.net/Services/_base/Service.cs`
- [API requestor](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/Public/ApiRequestor.cs): `src/Stripe.net/Infrastructure/Public/ApiRequestor.cs`
- [HTTP transport](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/Public/SystemNetHttpClient.cs): `src/Stripe.net/Infrastructure/Public/SystemNetHttpClient.cs`

### Typed models

- [Entity base](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Entities/_base/StripeEntity.cs): `src/Stripe.net/Entities/_base/StripeEntity.cs`
- [JSON converters](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/JsonConverters/STJStripeEntityConverter.cs): `src/Stripe.net/Infrastructure/JsonConverters/STJStripeEntityConverter.cs`
- [Date converters](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/JsonConverters/STJUnixDateTimeConverter.cs): `src/Stripe.net/Infrastructure/JsonConverters/STJUnixDateTimeConverter.cs`
- [Legacy date converter](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Infrastructure/JsonConverters/UnixDateTimeConverter.cs): `src/Stripe.net/Infrastructure/JsonConverters/UnixDateTimeConverter.cs`
- [Forwarding request](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Entities/Forwarding/Requests/Request.cs): `src/Stripe.net/Entities/Forwarding/Requests/Request.cs`

### Other components

- **SDK user**
- **Stripe API**

## Connections

- SDK user → StripeClient: configures
- SDK user → V1 services: calls operations
- StripeClient → V1 services: exposes (evidence: `src/Stripe.net/Infrastructure/Public/StripeClient.cs`)
- StripeClient → API requestor: delegates requests (evidence: `src/Stripe.net/Infrastructure/Public/StripeClient.cs`)
- V1 services → Identity sessions: provides service
- Identity sessions → Service base: uses (evidence: `src/Stripe.net/Services/Identity/VerificationSessions/VerificationSessionService.cs`)
- Issuing authorizations → Service base: uses (evidence: `src/Stripe.net/Services/Issuing/Authorizations/AuthorizationService.cs`)
- Reviews → Service base: uses (evidence: `src/Stripe.net/Services/Reviews/ReviewService.cs`)
- Sigma queries → Service base: uses (evidence: `src/Stripe.net/Services/Sigma/ScheduledQueryRuns/ScheduledQueryRunService.cs`)
- 3DS authentications → Service base: uses (evidence: `src/Stripe.net/Services/ThreeDSecure/Authentications/AuthenticationService.cs`)
- Service base → API requestor: sends requests (evidence: `src/Stripe.net/Services/_base/Service.cs`)
- API requestor → HTTP transport: uses transport
- API requestor → Stripe API: requests data (evidence: `src/Stripe.net/Infrastructure/Public/ApiRequestor.cs`)
- Request options → StripeClient: configures requests (evidence: `src/Stripe.net/Infrastructure/Public/StripeClient.cs`)
- API requestor → Entity base: returns typed data
- JSON converters → Entity base: converts
- Date converters → Entity base: converts dates
- Legacy date converter → Entity base: converts dates
- Forwarding request → Entity base: extends (evidence: `src/Stripe.net/Entities/Forwarding/Requests/Request.cs`)
