Struct PaymentUseCases 

pub struct PaymentUseCases { /* private fields */ }

Implementations

impl PaymentUseCases

pub fn new( payment_repository: Arc<dyn PaymentRepository>, payment_method_repository: Arc<dyn PaymentMethodRepository>, ) -> Self

pub async fn create_payment( &self, organization_id: Uuid, request: CreatePaymentRequest, ) -> Result<PaymentResponse, String>

Create a new payment

Generates a unique idempotency key to prevent duplicate charges. Checks for existing payment with same idempotency key (prevents retries from creating duplicates).

pub async fn get_payment( &self, id: Uuid, ) -> Result<Option<PaymentResponse>, String>

Get payment by ID

pub async fn get_payment_by_stripe_intent( &self, stripe_payment_intent_id: &str, ) -> Result<Option<PaymentResponse>, String>

Get payment by Stripe payment intent ID

pub async fn list_owner_payments( &self, owner_id: Uuid, ) -> Result<Vec<PaymentResponse>, String>

List payments for an owner

pub async fn list_building_payments( &self, building_id: Uuid, ) -> Result<Vec<PaymentResponse>, String>

List payments for a building

pub async fn list_expense_payments( &self, expense_id: Uuid, ) -> Result<Vec<PaymentResponse>, String>

List payments for an expense

pub async fn list_organization_payments( &self, organization_id: Uuid, ) -> Result<Vec<PaymentResponse>, String>

List payments for an organization

pub async fn list_payments_by_status( &self, organization_id: Uuid, status: TransactionStatus, ) -> Result<Vec<PaymentResponse>, String>

List payments by status

pub async fn list_pending_payments( &self, organization_id: Uuid, ) -> Result<Vec<PaymentResponse>, String>

List pending payments (for background processing)

pub async fn list_failed_payments( &self, organization_id: Uuid, ) -> Result<Vec<PaymentResponse>, String>

List failed payments (for retry or analysis)

pub async fn mark_processing(&self, id: Uuid) -> Result<PaymentResponse, String>

Mark payment as processing

pub async fn mark_requires_action( &self, id: Uuid, ) -> Result<PaymentResponse, String>

Mark payment as requiring action (e.g., 3D Secure)

pub async fn mark_succeeded(&self, id: Uuid) -> Result<PaymentResponse, String>

Mark payment as succeeded

pub async fn mark_failed( &self, id: Uuid, reason: String, ) -> Result<PaymentResponse, String>

Mark payment as failed

pub async fn mark_cancelled(&self, id: Uuid) -> Result<PaymentResponse, String>

Mark payment as cancelled

pub async fn refund_payment( &self, id: Uuid, request: RefundPaymentRequest, ) -> Result<PaymentResponse, String>

Refund payment (partial or full)

pub async fn set_stripe_payment_intent_id( &self, id: Uuid, stripe_payment_intent_id: String, ) -> Result<PaymentResponse, String>

Set Stripe payment intent ID

pub async fn set_stripe_customer_id( &self, id: Uuid, stripe_customer_id: String, ) -> Result<PaymentResponse, String>

Set Stripe customer ID

pub async fn set_payment_method_id( &self, id: Uuid, payment_method_id: Uuid, ) -> Result<PaymentResponse, String>

Set payment method ID

pub async fn delete_payment(&self, id: Uuid) -> Result<bool, String>

Delete payment

pub async fn get_total_paid_for_expense( &self, expense_id: Uuid, ) -> Result<i64, String>

Get total paid for expense

pub async fn get_total_paid_by_owner( &self, owner_id: Uuid, ) -> Result<i64, String>

Get total paid by owner

pub async fn get_total_paid_for_building( &self, building_id: Uuid, ) -> Result<i64, String>

Get total paid for building

pub async fn get_owner_payment_stats( &self, owner_id: Uuid, ) -> Result<PaymentStatsResponse, String>

Get payment statistics for owner

pub async fn get_building_payment_stats( &self, building_id: Uuid, ) -> Result<PaymentStatsResponse, String>

Get payment statistics for building