This commit is contained in:
2026-07-12 04:34:44 +08:00
parent e7ce0f7bae
commit 909fdf46d6
43 changed files with 4727 additions and 0 deletions

View File

@@ -0,0 +1,140 @@
import '../vendor/stripe_sdk/lib/stripe_sdk.dart';
import '../vendor/stripe_sdk/lib/stripe_sdk_ui.dart';
import 'mini_stripe_api_handler.dart';
class MiniStripeApi {
static MiniStripeApi? _instance;
final MiniStripeApiHandler _apiHandler;
final String publishableKey;
final String apiVersion;
/// Create a new instance, which can be used with e.g. dependency injection.
/// Throws a [Exception] if an invalid [publishableKey] has been submitted.
///
/// [publishableKey] is your publishable key, beginning with "sk_".
/// Your can copy your key from https://dashboard.stripe.com/account/apikeys
///
/// [stripeAccount] is the id of a stripe customer and stats with "cus_".
/// This is a optional parameter.
MiniStripeApi(this.publishableKey, {this.apiVersion = defaultApiVersion, String? stripeAccount})
: _apiHandler = MiniStripeApiHandler(stripeAccount: stripeAccount) {
_validateKey(publishableKey);
_apiHandler.apiVersion = apiVersion;
}
/// Initialize the managed singleton instance of [StripeApi].
/// Afterwards you can use [StripeApi.instance] to access the created instance.
///
/// [publishableKey] is your publishable key, beginning with "sk_".
/// Your can copy your key from https://dashboard.stripe.com/account/apikeys
///
/// [stripeAccount] is the id of a stripe customer and stats with "cus_".
/// This is a optional parameter.
static void init(String publishableKey, {String apiVersion = defaultApiVersion, String? stripeAccount}) {
// _instance ??= MiniStripeApi(publishableKey, uuidString, apiVersion: apiVersion, stripeAccount: stripeAccount);
_instance = MiniStripeApi(publishableKey, apiVersion: apiVersion, stripeAccount: stripeAccount);
}
/// Access the singleton instance of [StripeApi].
/// Throws an [Exception] if [StripeApi.init] hasn't been called previously.
static MiniStripeApi get instance {
if (_instance == null) {
throw Exception('Attempted to get singleton instance of StripeApi without initialization');
}
return _instance!;
}
/// Create a stripe Token
/// https://stripe.com/docs/api/tokens
Future<Map<String, dynamic>> createToken(Map<String, dynamic> data) async {
final path = '/tokens';
return _apiHandler.request(RequestMethod.post, path, publishableKey, apiVersion, params: data);
}
/// Create a PaymentMethod.
/// https://stripe.com/docs/api/payment_methods/create
Future<Map<String, dynamic>> createPaymentMethod(Map<String, dynamic> data) async {
final path = '/payment_methods';
return _apiHandler.request(RequestMethod.post, path, publishableKey, apiVersion, params: data);
}
/// Create a PaymentMethod from a card.
/// This will only create a PaymentMethod with the minimum required properties.
/// To include additional properties such as billing details, use [StripeCard.toPaymentMethod], add additional details
/// and then use [createPaymentMethod].
Future<Map<String, dynamic>> createPaymentMethodFromCard(StripeCard card) async {
return createPaymentMethod(card.toPaymentMethod());
}
/// Create a new Source object.
/// https://stripe.com/docs/api/sources/create
Future<Map<String, dynamic>> createSource(Map<String, dynamic> data) async {
final path = '/sources';
return _apiHandler.request(RequestMethod.post, path, publishableKey, apiVersion, params: data);
}
/// Retrieve a PaymentIntent.
/// https://stripe.com/docs/api/payment_intents/retrieve
Future<Map<String, dynamic>> retrievePaymentIntent(String clientSecret, {String? apiVersion}) async {
final intentId = _parseIdFromClientSecret(clientSecret);
final path = '/payment_intents/$intentId';
final params = {'client_secret': clientSecret};
return _apiHandler.request(RequestMethod.get, path, publishableKey, apiVersion ?? this.apiVersion, params: params);
}
/// Confirm a PaymentIntent
/// https://stripe.com/docs/api/payment_intents/confirm
Future<Map<String, dynamic>> confirmPaymentIntent(String clientSecret, {Map<String, dynamic>? data, String? idempotencyKey}) async {
final params = data ?? {};
final intent = _parseIdFromClientSecret(clientSecret);
params['client_secret'] = clientSecret;
final path = '/payment_intents/$intent/confirm';
return _apiHandler.request(RequestMethod.post, path, publishableKey, apiVersion, params: params, idempotencyKey: idempotencyKey);
}
/// Retrieve a SetupIntent.
/// https://stripe.com/docs/api/setup_intents/retrieve
Future<Map<String, dynamic>> retrieveSetupIntent(String clientSecret, {String? apiVersion}) async {
final intentId = _parseIdFromClientSecret(clientSecret);
final path = '/setup_intents/$intentId';
final params = {'client_secret': clientSecret};
return _apiHandler.request(RequestMethod.get, path, publishableKey, apiVersion, params: params);
}
/// Confirm a SetupIntent
/// https://stripe.com/docs/api/setup_intents/confirm
Future<Map<String, dynamic>> confirmSetupIntent(String clientSecret, {Map<String, dynamic>? data}) async {
final params = data ?? {};
final intent = _parseIdFromClientSecret(clientSecret);
params['client_secret'] = clientSecret;
final path = '/setup_intents/$intent/confirm';
return _apiHandler.request(RequestMethod.post, path, publishableKey, apiVersion, params: params);
}
/// Validates the received [publishableKey] and throws a [Exception] if an
/// invalid key has been submitted.
static void _validateKey(String publishableKey) {
if (publishableKey == null || publishableKey.isEmpty) {
throw Exception('Invalid Publishable Key: '
'You must use a valid publishable key to create a token. '
'For more info, see https://stripe.com/docs/stripe.js.');
}
if (publishableKey.startsWith('sk_')) {
throw Exception('Invalid Publishable Key: '
'You are using a secret key to create a token, '
'instead of the publishable one. For more info, '
'see https://stripe.com/docs/stripe.js');
}
}
}
String _parseIdFromClientSecret(String clientSecret) {
return clientSecret.split('_secret')[0];
}