How stripe/stripe-java works
stripe-java is Stripe’s official Java client SDK. An application configures a client and invokes typed service methods; those services turn parameters into API requests, pass them through the response-getter abstraction, and return typed Stripe models or collections. The tree also exposes broad API-domain services and webhook notification handling. Relationships among unsampled service families are kept at subsystem level; the excerpts do not establish their internal routing or the full transport implementation.
Main entry points: ApiService.java Service base · SessionService.java Checkout sessions · ApiRequest.java API request · ReviewService.java Review operations
Components 24
Client entry
- Stripe client
src/main/java/com/stripe/StripeClient.java - Legacy API
src/main/java/com/stripe/Stripe.java
API services
- Domain services
src/main/java/com/stripe/service - Checkout sessions
src/main/java/com/stripe/service/checkout/SessionService.java - Checkout line items
src/main/java/com/stripe/service/checkout/SessionLineItemService.java - Review operations
src/main/java/com/stripe/service/ReviewService.java - Identity verification
src/main/java/com/stripe/service/identity/VerificationSessionService.java - Issuing authorizations
src/main/java/com/stripe/service/issuing/AuthorizationService.java - Sigma query runs
src/main/java/com/stripe/service/sigma/ScheduledQueryRunService.java - Test helper APIs
src/main/java/com/stripe/service/testhelpers
Request and transport
- Typed parameters
src/main/java/com/stripe/net/ApiRequestParams.java - API request
src/main/java/com/stripe/net/ApiRequest.java - Request options
src/main/java/com/stripe/net/RequestOptions.java - Service base
src/main/java/com/stripe/net/ApiService.java - Response getter
src/main/java/com/stripe/net/StripeResponseGetter.java - Resource utilities
src/main/java/com/stripe/net/ApiResource.java - API addresses
src/main/java/com/stripe/net/BaseAddress.java
Models and events
- Typed models
src/main/java/com/stripe/model/StripeObject.java - Paged collections
src/main/java/com/stripe/model/StripeCollection.java - API exceptions
src/main/java/com/stripe/exception/StripeException.java - Webhook handlers
src/main/java/com/stripe/StripeEventNotificationHandler.java - Event notifications
src/main/java/com/stripe/events
Other components
- Java application
- Stripe API
Connections 27
- Java application → Stripe client: configures and calls
README.md - Java application → Legacy API: may use
README.md - Checkout sessions → Checkout line items: creates
src/main/java/com/stripe/service/checkout/SessionService.java - Checkout sessions → Service base: extends
src/main/java/com/stripe/service/checkout/SessionService.java - Checkout line items → Service base: extends
src/main/java/com/stripe/service/checkout/SessionLineItemService.java - Review operations → Service base: extends
src/main/java/com/stripe/service/ReviewService.java - Identity verification → Service base: extends
src/main/java/com/stripe/service/identity/VerificationSessionService.java - Issuing authorizations → Service base: extends
src/main/java/com/stripe/service/issuing/AuthorizationService.java - Sigma query runs → Service base: extends
src/main/java/com/stripe/service/sigma/ScheduledQueryRunService.java - Domain services → Service base: extend service base
src/main/java/com/stripe/service/sigma/ScheduledQueryRunService.java - Test helper APIs → Service base: extend service base
src/main/java/com/stripe/service/testhelpers/issuing/AuthorizationService.java - Checkout sessions → Typed parameters: converts parameters
src/main/java/com/stripe/service/checkout/SessionService.java - Review operations → Typed parameters: converts parameters
src/main/java/com/stripe/service/ReviewService.java - Checkout sessions → API request: builds requests
src/main/java/com/stripe/service/checkout/SessionService.java - Review operations → API request: builds requests
src/main/java/com/stripe/service/ReviewService.java - API request → API addresses: selects address
src/main/java/com/stripe/service/checkout/SessionService.java - API request → Request options: carries options
src/main/java/com/stripe/service/checkout/SessionService.java - Service base → Response getter: sends request
src/main/java/com/stripe/net/ApiService.java - Response getter → Stripe API: makes API call
- Service base → API request: adds usage metadata
src/main/java/com/stripe/net/ApiService.java - Resource utilities → Typed models: configures serialization
src/main/java/com/stripe/net/ApiResource.java - Checkout sessions → Typed models: returns typed results
src/main/java/com/stripe/service/checkout/SessionService.java - Checkout line items → Paged collections: returns paged items
src/main/java/com/stripe/service/checkout/SessionLineItemService.java - Review operations → Paged collections: returns paged results
src/main/java/com/stripe/service/ReviewService.java - Response getter → API exceptions: reports failures
src/main/java/com/stripe/net/StripeResponseGetter.java - Java application → Webhook handlers: handles notifications
- Webhook handlers → Event notifications: dispatches event types