# xamarin/xamarinstripe architecture

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

## Overview

XamarinStripe is a .NET client library for Stripe payments. The principal workflow is an application calling the client, which builds HTTP requests to Stripe and returns typed payment/customer/billing objects. Separate model branches cover charges and disputes, customer cards, subscriptions and plans, invoices, and coupons; form encoders and JSON converters support request and response handling. The README and sampled client establish the HTTP-client role, while many endpoint details and model relationships are known only from the source index, so uncertain links are omitted.

Main entry points: [`XamarinStripe/StripePayment.cs`](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripePayment.cs) (Stripe client), [`XamarinStripe/StripeObjectConverter.cs`](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeObjectConverter.cs) (Object converter), [`XamarinStripe/IUrlEncoderInfo.cs`](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/IUrlEncoderInfo.cs) (Form encoder interface), [`XamarinStripe/StripeSubscription.cs`](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeSubscription.cs) (Subscriptions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["API client"]
  node_client["Stripe client<br/>[StripePayment.cs]"]
end

subgraph group_requests["Request encoding"]
  node_cardinput["Card input"]
  node_customerinput["Customer input"]
  node_planinput["Plan input<br/>[StripePlanInfo.cs]"]
  node_subscriptioninput["Subscription input"]
  node_invoiceiteminput["Invoice item input"]
  node_encoder["Form encoder interface<br/>[IUrlEncoderInfo.cs]"]
end

subgraph group_billing["Billing models"]
  node_subscription["Subscriptions"]
  node_plan["Plans<br/>[StripePlan.cs]"]
  node_invoice["Invoices and lines<br/>[StripeInvoice.cs]"]
  node_invoiceitem["Invoice items"]
  node_coupon["Coupons<br/>[StripeCoupon.cs]"]
end

subgraph group_payments["Payment models"]
  node_charge["Charges and disputes<br/>[StripeCharge.cs]"]
  node_customer["Customer and cards<br/>[StripeCustomer.cs]"]
  node_token["Card tokens"]
end

subgraph group_serialization["Serialization"]
  node_collection["Paged collections"]
  node_objectconverter["Object converter"]
  node_dateconverter["Unix date converter"]
  node_enumconverter["Enum converter"]
end

node_app(("Application"))
node_stripe["Stripe API"]

node_app -->|"calls"| node_client
node_client -->|"HTTP requests"| node_stripe
node_client -->|"encodes card"| node_cardinput
node_cardinput -->|"implements"| node_encoder
node_client -.->|"encodes input"| node_customerinput
node_client -.->|"encodes input"| node_planinput
node_client -.->|"encodes input"| node_subscriptioninput
node_client -->|"encodes input"| node_invoiceiteminput
node_customerinput -->|"implements"| node_encoder
node_planinput -->|"implements"| node_encoder
node_subscriptioninput -->|"implements"| node_encoder
node_invoiceiteminput -->|"implements"| node_encoder
node_client -->|"returns"| node_charge
node_client -->|"returns"| node_customer
node_client -->|"returns"| node_token
node_client -->|"returns"| node_subscription
node_client -->|"returns"| node_plan
node_client -->|"returns"| node_invoice
node_client -->|"returns"| node_invoiceitem
node_client -->|"returns"| node_coupon
node_client -->|"returns"| node_collection
node_objectconverter -->|"converts"| node_charge
node_objectconverter -->|"converts"| node_customer
node_objectconverter -->|"converts"| node_subscription
node_objectconverter -->|"converts"| node_invoice
node_objectconverter -->|"converts"| node_coupon
node_charge -->|"uses dates"| node_dateconverter
node_invoice -->|"uses dates"| node_dateconverter
node_subscription -->|"uses dates"| node_dateconverter
node_subscription -->|"uses status"| node_enumconverter

click node_client "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripePayment.cs"
click node_cardinput "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCreditCardInfo.cs"
click node_customerinput "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCustomerInfo.cs"
click node_planinput "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripePlanInfo.cs"
click node_subscriptioninput "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeSubscriptionInfo.cs"
click node_invoiceiteminput "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeInvoiceItemInfo.cs"
click node_encoder "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/IUrlEncoderInfo.cs"
click node_charge "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCharge.cs"
click node_customer "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCustomer.cs"
click node_token "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCreditCardToken.cs"
click node_subscription "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeSubscription.cs"
click node_plan "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripePlan.cs"
click node_invoice "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeInvoice.cs"
click node_invoiceitem "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeInvoiceItem.cs"
click node_coupon "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCoupon.cs"
click node_collection "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCollection.cs"
click node_objectconverter "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeObjectConverter.cs"
click node_dateconverter "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/UnixDateTimeConverter.cs"
click node_enumconverter "https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeEnumConverter.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 toneBlue
class node_cardinput,node_customerinput,node_planinput,node_subscriptioninput,node_invoiceiteminput,node_encoder toneAmber
class node_subscription,node_plan,node_invoice,node_invoiceitem,node_coupon,node_stripe toneMint
class node_charge,node_customer,node_token toneRose
class node_collection,node_objectconverter,node_dateconverter,node_enumconverter,node_app toneIndigo
```

## Components

### API client

- [Stripe client](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripePayment.cs): `XamarinStripe/StripePayment.cs`

### Request encoding

- [Card input](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCreditCardInfo.cs): `XamarinStripe/StripeCreditCardInfo.cs`
- [Customer input](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCustomerInfo.cs): `XamarinStripe/StripeCustomerInfo.cs`
- [Plan input](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripePlanInfo.cs): `XamarinStripe/StripePlanInfo.cs`
- [Subscription input](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeSubscriptionInfo.cs): `XamarinStripe/StripeSubscriptionInfo.cs`
- [Invoice item input](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeInvoiceItemInfo.cs): `XamarinStripe/StripeInvoiceItemInfo.cs`
- [Form encoder interface](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/IUrlEncoderInfo.cs): `XamarinStripe/IUrlEncoderInfo.cs`

### Billing models

- [Subscriptions](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeSubscription.cs): `XamarinStripe/StripeSubscription.cs`
- [Plans](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripePlan.cs): `XamarinStripe/StripePlan.cs`
- [Invoices and lines](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeInvoice.cs): `XamarinStripe/StripeInvoice.cs`
- [Invoice items](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeInvoiceItem.cs): `XamarinStripe/StripeInvoiceItem.cs`
- [Coupons](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCoupon.cs): `XamarinStripe/StripeCoupon.cs`

### Payment models

- [Charges and disputes](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCharge.cs): `XamarinStripe/StripeCharge.cs`
- [Customer and cards](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCustomer.cs): `XamarinStripe/StripeCustomer.cs`
- [Card tokens](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCreditCardToken.cs): `XamarinStripe/StripeCreditCardToken.cs`

### Serialization

- [Paged collections](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeCollection.cs): `XamarinStripe/StripeCollection.cs`
- [Object converter](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeObjectConverter.cs): `XamarinStripe/StripeObjectConverter.cs`
- [Unix date converter](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/UnixDateTimeConverter.cs): `XamarinStripe/UnixDateTimeConverter.cs`
- [Enum converter](https://github.com/xamarin/xamarinstripe/blob/master/XamarinStripe/StripeEnumConverter.cs): `XamarinStripe/StripeEnumConverter.cs`

### Other components

- **Application**
- **Stripe API**

## Connections

- Application → Stripe client: calls
- Stripe client → Stripe API: HTTP requests (evidence: `XamarinStripe/StripePayment.cs`)
- Stripe client → Card input: encodes card (evidence: `XamarinStripe/StripePayment.cs`)
- Card input → Form encoder interface: implements (evidence: `XamarinStripe/StripeCreditCardInfo.cs`)
- Stripe client → Customer input: encodes input (evidence: `XamarinStripe/StripePayment.cs`)
- Stripe client → Plan input: encodes input (evidence: `XamarinStripe/StripePayment.cs`)
- Stripe client → Subscription input: encodes input (evidence: `XamarinStripe/StripePayment.cs`)
- Stripe client → Invoice item input: encodes input (evidence: `XamarinStripe/StripePayment.cs`)
- Customer input → Form encoder interface: implements (evidence: `XamarinStripe/StripeCustomerInfo.cs`)
- Plan input → Form encoder interface: implements (evidence: `XamarinStripe/StripePlanInfo.cs`)
- Subscription input → Form encoder interface: implements (evidence: `XamarinStripe/StripeSubscriptionInfo.cs`)
- Invoice item input → Form encoder interface: implements (evidence: `XamarinStripe/StripeInvoiceItemInfo.cs`)
- Stripe client → Charges and disputes: returns (evidence: `XamarinStripe/StripePayment.cs`)
- Stripe client → Customer and cards: returns (evidence: `XamarinStripe/StripePayment.cs`)
- Stripe client → Card tokens: returns (evidence: `XamarinStripe/StripePayment.cs`)
- Stripe client → Subscriptions: returns (evidence: `XamarinStripe/StripePayment.cs`)
- Stripe client → Plans: returns (evidence: `XamarinStripe/StripePayment.cs`)
- Stripe client → Invoices and lines: returns (evidence: `XamarinStripe/StripePayment.cs`)
- Stripe client → Invoice items: returns (evidence: `XamarinStripe/StripePayment.cs`)
- Stripe client → Coupons: returns (evidence: `XamarinStripe/StripePayment.cs`)
- Stripe client → Paged collections: returns (evidence: `XamarinStripe/StripePayment.cs`)
- Object converter → Charges and disputes: converts (evidence: `XamarinStripe/StripeObjectConverter.cs`)
- Object converter → Customer and cards: converts (evidence: `XamarinStripe/StripeObjectConverter.cs`)
- Object converter → Subscriptions: converts (evidence: `XamarinStripe/StripeObjectConverter.cs`)
- Object converter → Invoices and lines: converts (evidence: `XamarinStripe/StripeObjectConverter.cs`)
- Object converter → Coupons: converts (evidence: `XamarinStripe/StripeObjectConverter.cs`)
- Charges and disputes → Unix date converter: uses dates (evidence: `XamarinStripe/StripeCharge.cs`)
- Invoices and lines → Unix date converter: uses dates (evidence: `XamarinStripe/StripeInvoice.cs`)
- Subscriptions → Unix date converter: uses dates (evidence: `XamarinStripe/StripeSubscription.cs`)
- Subscriptions → Enum converter: uses status (evidence: `XamarinStripe/StripeSubscription.cs`)
