provider

type ExchangeRateProvider interface {
	// GetRate fetches the current exchange rate for a currency pair.
	GetRate(from, to string) (*domain.ExchangeRate, error)

	// GetRates fetches multiple exchange rates in a single request.
	GetRates(from string, to []string) (map[string]*domain.ExchangeRate, error)

	// Name returns the provider's name for logging and identification.
	Name() string

	// IsHealthy checks if the provider is currently available.
	IsHealthy() bool
}

type GetPaymentStatusParams struct {
	PaymentID string
}

type InitiatePaymentParams struct {
	UserID        uuid.UUID
	AccountID     uuid.UUID
	TransactionID uuid.UUID
	Amount        int64
	Currency      string
}

type InitiatePaymentResponse struct {
	Status PaymentStatus
	// PaymentID is the ID of the payment in the payment provider
	// (e.g., Stripe Checkout Session ID)
	PaymentID string
}

type PaymentEvent struct {
	ID        string
	Status    PaymentStatus
	Amount    int64
	Currency  string
	UserID    uuid.UUID
	AccountID uuid.UUID
	Metadata  map[string]string
}

type PaymentProvider interface {
	InitiatePayment(
		ctx context.Context,
		params *InitiatePaymentParams,
	) (*InitiatePaymentResponse, error)
	GetPaymentStatus(
		ctx context.Context,
		params *GetPaymentStatusParams,
	) (PaymentStatus, error)
	HandleWebhook(
		payload []byte,
		signature string,
	) (*PaymentEvent, error)
	UpdatePaymentStatus(ctx context.Context, i *UpdatePaymentStatusParams) error
}

type PaymentStatus string

type UpdatePaymentStatusParams struct {
	TransactionID uuid.UUID
	PaymentID     string
	Status        PaymentStatus
}