payment

type BankAccountDetails struct {
	AccountNumber     string `json:"account_number"`
	RoutingNumber     string `json:"routing_number"`
	AccountHolderName string `json:"account_holder_name"`
}

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 InitiatePayoutParams struct {
	UserID            uuid.UUID
	AccountID         uuid.UUID
	PaymentProviderID string
	TransactionID     uuid.UUID
	Amount            int64
	Currency          string
	Destination       PayoutDestination
	Description       string
	Metadata          map[string]string
}

type InitiatePayoutResponse struct {
	PayoutID             string
	PaymentProviderID    string
	Status               PaymentStatus
	Amount               int64
	Currency             string
	FeeAmount            int64
	FeeCurrency          string
	EstimatedArrivalDate int64 // Unix timestamp
}

type Payment interface {
	InitiatePayment(
		ctx context.Context,
		params *InitiatePaymentParams,
	) (*InitiatePaymentResponse, error)

	HandleWebhook(
		ctx context.Context,
		payload []byte,
		signature string,
	) (*PaymentEvent, error)

	// InitiatePayout initiates a payout to a connected account
	InitiatePayout(
		ctx context.Context,
		params *InitiatePayoutParams,
	) (*InitiatePayoutResponse, error)
}

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

type PaymentEventType string

type PaymentStatus string

type PayoutDestination struct {
	Type           PayoutDestinationType
	BankAccount    *BankAccountDetails `json:"bank_account,omitempty"`
	ExternalWallet *string             `json:"external_wallet,omitempty"`
}

type PayoutDestinationType string

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