stripe_api_client 0.2.4

Stripe API Client generated from OpenAPI specification

Stripe API Client

⚠️ Disclaimer: This is an unofficial package and is not affiliated with or endorsed by Stripe, Inc.

A Dart package providing a complete Stripe API client, automatically generated from the official Stripe OpenAPI specification.

Features

• ✅ Automatically generated from Stripe's latest OpenAPI specification
• ✅ Complete type-safe Dart API client
• ✅ Generated using Microsoft Kiota
• ✅ Built-in serialization support
• ✅ Always up-to-date with Stripe's API

Installation

Add this package to your pubspec.yaml:

dependencies:
  stripe_api_client: ^0.2.2

Then run:

dart pub get

Alternative: Install from Git

If you need the latest development version, you can install directly from GitHub:

dependencies:
  stripe_api_client:
    git:
      url: https://github.com/univelop/stripe_api_client.git
      ref: main

Usage

Basic Example with Stripe API Key Authentication

import 'package:stripe_api_client/stripe_api_client.dart';
import 'package:stripe_api_client/v1/customers/customers_get_request_body.dart';
import 'package:microsoft_kiota_bundle/microsoft_kiota_bundle.dart';
import 'package:microsoft_kiota_abstractions/microsoft_kiota_abstractions.dart';

// Setup
final apiKey = 'sk_test_your_api_key_here';
final authProvider = ApiKeyAuthenticationProvider(
  apiKey: 'Bearer $apiKey',
  parameterName: 'Authorization',
  keyLocation: ApiKeyLocation.header,
);
final requestAdapter = DefaultRequestAdapter(authProvider: authProvider);
final client = StripeClient(requestAdapter);

// Make API calls
final response = await client.v1.customers.getAsync(
  CustomersGetRequestBody(),
);

For more details on authentication providers and usage patterns, see the Kiota Dart Quickstart.

Working Example

See the example/ directory for a complete working example that demonstrates:

• How to set up authentication with Stripe API keys
• How to list customers from your Stripe account
• How to use environment variables for configuration

The example includes detailed setup instructions in example/README.md.

Development

Prerequisites

To generate code from the Stripe OpenAPI specification, you need to install kiota. Choose one of the following installation methods:

Option 1: Homebrew (macOS)

brew install microsoft/kiota/kiota

Option 2: Direct Download

Download the latest release from Kiota Releases for your platform.

Option 3: Package Managers

• Linux: See installation instructions at Get Kiota for Linux
• Windows: See installation instructions at Get Kiota for Windows

For more installation options, see the Kiota Installation Guide.

Generating Code

This package uses a shell script to automatically generate code from the Stripe OpenAPI specification.

To generate the code:

./generate.sh

The script will:

1. Download the latest Stripe OpenAPI specification from GitHub
2. Use kiota to generate Dart code
3. Copy generated code into the package structure
4. Format the generated code
5. Clean up temporary files

How It Works

1. The script downloads the latest Stripe OpenAPI specification from GitHub
2. kiota generates Dart code using the dart language generator
3. Generated code is copied into the package structure
4. The generated code is formatted using dart format
5. The package is ready to use

Project Structure

stripe_api_client/
├── example/           # Working example demonstrating usage
│   ├── list_customers.dart
│   └── README.md
├── lib/
│   ├── api/          # Generated API client classes
│   ├── model/         # Generated data models
│   ├── auth/          # Authentication utilities
│   └── ...
├── pubspec.yaml
└── README.md

Versioning

This package follows Semantic Versioning. The version number reflects changes in the generated code based on Stripe's API updates:

• PATCH: Backward-compatible bug fixes, spec clarifications
• MINOR: New endpoints, new optional fields, new enum values
• MAJOR: Breaking changes (removed endpoints, required field changes, type changes)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright (c) 2025 Univelop GmbH

Links

• Stripe API Documentation
• Stripe OpenAPI Specification
• Kiota Documentation
• Kiota Dart Quickstart
• Kiota GitHub