Skip to content

Deep analysis of payment implementation (@explore subagent)

Field Value
Source opencode CLI/web
Session ses_292094aa7ffewiaOEEyq41Nz5F
Started 2026-04-08 16:39
Messages 11
Parts 52 (text+patch+tool) · 10 reasoning · 17 tool calls
Model —
Directory /home/sambasene/Downloads/TStore-Firebase-main

Analyze the payment implementation in depth. Read and analyze:

  1. lib/features/payment/payment_injection.dart - Payment dependency injection
  2. lib/features/payment/data/repositories/payment_repository_impl.dart - Payment repository
  3. lib/features/payment/domain/usecases/payment_intent_usecase.dart - Payment use case
  4. lib/features/payment/presentation/cubit/payment_cubit.dart - Payment cubit
  5. lib/features/payment/core/storage/payment_storage.dart - Payment storage

Explain the payment flow, Stripe integration, and payment methods handling.

I’ll read all 5 payment-related files to analyze the payment implementation.

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/payment_injection.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/payment_injection.dart</path>
<type>file</type>
<content>
1: import 'package:get_it/get_it.dart';
2: import 'package:t_store/core/network/api_client.dart';
3: import 'package:t_store/features/payment/core/storage/payment_storage.dart';
4: import 'package:t_store/features/payment/data/datasources/cash_payment_service.dart';
5: import 'package:t_store/features/payment/data/datasources/customer_service/i_customer_service.dart';
6: import 'package:t_store/features/payment/data/datasources/customer_service/stripe_customer_sevice.dart';
7: import 'package:t_store/features/payment/data/datasources/fawry_payment_service.dart';
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/repositories/payment_repository_impl.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/repositories/payment_repository_impl.dart</path>
<type>file</type>
<content>
1: import 'package:dartz/dartz.dart';
2: import 'package:t_store/core/errors/failures.dart';
3: import 'package:t_store/features/payment/data/data.dart';
4: import 'package:t_store/features/payment/data/mappers/payment_details_mappre.dart';
5: import 'package:t_store/features/payment/domain/domain.dart';
6:
7: class PaymentRepositoryImpl implements PaymentRepository {
8: final PaymentRemoteDatasource paymentRemoteDatasource;
9: PaymentRepositoryImpl(this.paymentRemoteDatasource);
10:
11: @override
12: Future<List<CardMethodEntity>> getA
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/usecases/payment_intent_usecase.dart"}

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/presentation/cubit/payment_cubit.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/presentation/cubit/payment_cubit.dart</path>
<type>file</type>
<content>
1: import 'package:cloud_firestore/cloud_firestore.dart';
2: import 'package:flutter_bloc/flutter_bloc.dart';
3: import 'package:t_store/core/config/service_locator.dart';
4: import 'package:t_store/features/checkout/domain/entities/order_entity.dart';
5: import 'package:t_store/features/payment/core/enums/payment_method.dart';
6: import 'package:t_store/features/payment/domain/entities/payment_details_entity.dart';
7: import 'package:t_store/features/payment/domain/entities/card_method_entity.dart';
8: import 'package:t_store/features/payment/dom
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/core/storage/payment_storage.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/core/storage/payment_storage.dart</path>
<type>file</type>
<content>
1: import 'package:shared_preferences/shared_preferences.dart';
2: import 'package:t_store/features/payment/core/constants/storage_keys.dart';
3:
4: class PaymentStorage {
5: static PaymentStorage? _instance;
6: PaymentStorage._internal();
7:
8: static PaymentStorage get instance =>
9: _instance ??= PaymentStorage._internal();
10:
11: static late SharedPreferences? _prefs;
12:
13: static Future<void> init() async {
14: _prefs = await SharedPreferences.getInstance();
15: }
16:
17: Future<void> saveDefaultMethodId(String methodId) async {
18: await
…[truncated]

The file payment_intent_usecase.dart doesn’t exist. Let me search for similar payment use case files to find the correct one:

glob — {"pattern": "lib/features/payment/domain/usecases/*.dart"}

/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/usecases/usecases.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/usecases/get_default_payment_method.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/usecases/update_default_method_usecase.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/usecases/delete_payment_method_usecase.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/usecases/payment_usecases.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/usecases/delete_customer_usecase.dart
/home/sambasene/Downloads/TSt
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/usecases/payment_usecases.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/usecases/payment_usecases.dart</path>
<type>file</type>
<content>
1: import 'package:t_store/features/payment/domain/domain.dart';
2:
3: class PaymentUsecases {
4: final PayUseCase payUseCase;
5: final GetPaymentMethodsUsecase getPaymnetMethodUsecase;
6:
7: PaymentUsecases(this.payUseCase, this.getPaymnetMethodUsecase);
8: }
(End of file - total 8 lines)
</content>

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/usecases/pay_usecase.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/usecases/pay_usecase.dart</path>
<type>file</type>
<content>
1: import 'package:dartz/dartz.dart';
2: import 'package:t_store/core/errors/failures.dart';
3: import 'package:t_store/features/payment/core/enums/payment_method.dart';
4: import 'package:t_store/features/payment/domain/domain.dart';
5:
6: class PayUseCase {
7: final PaymentRepository _paymentRepository;
8: PayUseCase(this._paymentRepository);
9:
10: Future<Either<Failure, PaymentResultEntity>> pay({
11: required PaymentMethods method,
12: required PaymentDetailsEntity? details,
13: CardFlow? cardFlow = CardFlow.savedCard,
14: }) {
15: final service
…[truncated]

Let me explore the Stripe services, the factory, and other payment related files to complete the analysis:

glob — {"pattern": "lib/features/payment/data/datasources/**/*.dart"}

/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/cash_payment_service.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/i_card_flow_strategy.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/fawry_payment_service.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/datasources.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/vodafone_cash_payment_service.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/payment_remote_datasource.dart
/home/sambasene/Downloads/TS
…[truncated]

grep — {"path": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment", "pattern": "PaymentServiceFactory"}

Found 2 matches
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/usecases/pay_usecase.dart:
Line 15: final service = PaymentServiceFactory.create(method, cardFlow: cardFlow);
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/factories/payment_service_factory.dart:
Line 6: class PaymentServiceFactory {

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/factories/payment_service_factory.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/domain/factories/payment_service_factory.dart</path>
<type>file</type>
<content>
1: import 'package:t_store/core/config/service_locator.dart';
2: import 'package:t_store/features/payment/core/enums/payment_method.dart';
3: import 'package:t_store/features/payment/data/datasources/i_payment_service_strategy.dart';
4:
5: /// Simple Factory Pattern ///
6: class PaymentServiceFactory {
7: static IPaymentServiceStrategy create(PaymentMethods method,
8: {CardFlow? cardFlow}) {
9: switch (method) {
10: case PaymentMethods.stripe:
11: return createStripeWithFlow(cardFlow!);
12: case PaymentMethods.payPal:
13: return createPay
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/stripe_service/stripe_payment_service.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/stripe_service/stripe_payment_service.dart</path>
<type>file</type>
<content>
1: import 'package:t_store/features/payment/data/data.dart';
2:
3: class StripePaymentService implements IPaymentServiceStrategy {
4: final ICardFlowStrategy cardFlow;
5: StripePaymentService(this.cardFlow);
6:
7: @override
8: Future<PaymentResultModel> pay({required PaymentDetailsModel? details}) async {
9: return cardFlow.payWithCard(details: details);
10: }
11: }
(End of file - total 11 lines)
</content>

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/stripe_service/base_stripe_card_flow_strategy.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/stripe_service/base_stripe_card_flow_strategy.dart</path>
<type>file</type>
<content>
1: import 'package:t_store/features/payment/data/datasources/i_card_flow_strategy.dart';
2:
3: /// --- Stripe Shared Logic --- ///
4: abstract class BaseStripeCardFlowStrategy implements ICardFlowStrategy {
5: // shared methods: createPaymentIntent, confirmPayment
6: }
(End of file - total 6 lines)
</content>

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/stripe_service/stripe_new_card_flow_strategy.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/stripe_service/stripe_new_card_flow_strategy.dart</path>
<type>file</type>
<content>
1: import 'package:flutter_dotenv/flutter_dotenv.dart';
2: import 'package:flutter_stripe/flutter_stripe.dart';
3: import 'package:t_store/core/config/service_locator.dart';
4: import 'package:t_store/core/network/api_client.dart';
5: import 'package:t_store/core/utils/utils.dart';
6: import 'package:t_store/features/payment/core/storage/payment_storage.dart';
7: import 'package:t_store/features/payment/data/datasources/customer_service/i_customer_service.dart';
8: import 'package:t_store/features/payment/data/datasour
…[truncated]

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/stripe_service/stripe_saved_card_flow_strategy.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/data/datasources/stripe_service/stripe_saved_card_flow_strategy.dart</path>
<type>file</type>
<content>
1: import 'package:flutter_dotenv/flutter_dotenv.dart';
2: import 'package:flutter_stripe/flutter_stripe.dart';
3: import 'package:t_store/core/network/api_client.dart';
4: import 'package:t_store/core/utils/constants/enums.dart';
5: import 'package:t_store/features/payment/data/data.dart';
6: import 'package:t_store/core/utils/constants/api_constants.dart';
7:
8: class StripeSavedCardFlowStrategy implements ICardFlowStrategy {
9: final ApiClient dio;
10: final ICustomerService customerService;
11: StripeSavedCardFl
…[truncated]

glob — {"pattern": "lib/features/payment/core/enums/*.dart"}

/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/core/enums/payment_method.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/core/enums/payment_entry_point.dart
/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/core/enums/enums.dart

read — {"filePath": "/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/core/enums/payment_method.dart"}

<path>/home/sambasene/Downloads/TStore-Firebase-main/lib/features/payment/core/enums/payment_method.dart</path>
<type>file</type>
<content>
1: enum PaymentMethods {
2: stripe,
3: vodafone,
4: fawry,
5: payPal,
6: cashOnDelivery,
7: }
8:
9: enum CardFlow { newCard, savedCard }
(End of file - total 9 lines)
</content>

Now I have gathered comprehensive information about the payment implementation. Let me provide you with a detailed analysis.


1. Payment Dependency Injection (payment_injection.dart)

Section titled “1. Payment Dependency Injection (payment_injection.dart)”

This file sets up the entire payment module using GetIt for dependency injection. It registers:

API & Data Sources:

  • ApiClient - HTTP client for external API calls
  • PaymentRemoteDatasource - Firebase-based data source

Stripe Customer Service:

  • ICustomerService (instanceName: ‘stripeCustomer’) - StripeCustomerService for Stripe customer management

Card Flow Strategies (Strategy Pattern):

  • ICardFlowStrategy (instanceName: ‘stripeNewCardFlow’) - StripeNewCardFlowStrategy
  • ICardFlowStrategy (instanceName: ‘stripeSavedCardFlow’) - StripeSavedCardFlowStrategy

Payment Services (Factory Pattern with named instances):

  • Stripe: ‘stripeNewCard’, ‘stripeSavedCard’
  • PayPal: ‘payPal’
  • Local: ‘vodafone’, ‘fawry’, ‘cash’

Repositories:

  • PaymentRepository - PaymentRepositoryImpl
  • PaymentMethodRepository - PaymentMethodRepositoryImpl
  • CustomerRepository - CustomerRepositoryImpl

Use Cases:

  • PayUseCase - Execute payment
  • GetPaymentMethodsUsecase - Get available payment methods
  • GetDefaultPaymentMethod - Get default saved card
  • GetSavedPaymentMethodsUsecase - Get all saved cards
  • UpdateDefaultPaymentMethodUsecase - Change default card
  • AddPaymentMethodUsecase - Add new card
  • DeletePaymentMethodUsecase - Remove card

Cubits:

  • PaymentCubit - Main payment state management
  • PaymentMethodCubit - Payment methods management

2. Payment Repository (payment_repository_impl.dart)

Section titled “2. Payment Repository (payment_repository_impl.dart)”

This is a thin wrapper around the remote data source with error handling:

class PaymentRepositoryImpl implements PaymentRepository {
// Get available payment methods from Firebase
Future<List<CardMethodEntity>> getAvailableMethods()
// Execute payment using a service strategy
Future<Either<Failure, PaymentResultEntity>> pay({
required IPaymentServiceStrategy service,
required PaymentDetailsEntity? details,
})
}

Key points:

  • Uses Dartz for functional error handling (Either<Failure, Success>)
  • Returns empty list on error for getAvailableMethods()
  • Delegates actual payment to strategy pattern services

PaymentUsecases - Combines two use cases:

class PaymentUsecases {
final PayUseCase payUseCase;
final GetPaymentMethodsUsecase getPaymnetMethodUsecase;
}

PayUseCase - Main payment orchestration:

class PayUseCase {
Future<Either<Failure, PaymentResultEntity>> pay({
required PaymentMethods method,
required PaymentDetailsEntity? details,
CardFlow? cardFlow = CardFlow.savedCard,
}) {
// Factory creates the appropriate service strategy
final service = PaymentServiceFactory.create(method, cardFlow: cardFlow);
return _paymentRepository.pay(service: service, details: details);
}
}

Uses Factory Pattern to create the appropriate payment service based on:

  • PaymentMethods - stripe, paypal, vodafone, fawry, cashOnDelivery
  • CardFlow - newCard, savedCard

State management using Flutter BLoC pattern:

States:

enum PaymentStateStatus { initial, loading, success, failure }
enum PaymentAction { fetch, selectMethod, processPayment }

Key Methods:

  1. fetchServiceMethods() - Load available payment methods
  • Emits loading state, fetches from use case, emits success with methods
  1. selectMethod(CardMethodEntity method) - Select payment method
  • Updates selected method in state
  1. confirmPayment() - Execute payment and update order
  • Validates selected method exists
  • Calls payUseCase.pay() with method, details, cardFlow
  • On success: Updates order status in Firestore
  • Creates PaymentResultEntity with order summary and card type
  • Emits success/fail

…[truncated]

10 internal reasoning block(s) omitted — raw thinking is not exported (see archive index).