payments

type CheckoutSession struct {
	ID   string
	URL  string
	Mode string // payment|setup

	// Stripe checkout session lifecycle status (e.g. open|complete|expired).
	Status string
	// Stripe payment status (e.g. paid|unpaid|no_payment_required).
	PaymentStatus string

	CustomerID      string
	PaymentIntentID string
	SetupIntentID   string

	AmountTotal int64
	Currency    string

	Metadata  map[string]string
	ExpiresAt time.Time
}

type CreditsCheckoutInput struct {
	CustomerID string

	PurchaseID   string
	Username     string
	InstanceSlug string
	Month        string
	Credits      int64

	AmountCents int64
	Currency    string

	SuccessURL string
	CancelURL  string
}

type EnsureCustomerInput struct {
	Username string
	Email    string
}

type PaymentMethodDetails struct {
	ID    string
	Type  string
	Brand string
	Last4 string

	ExpMonth int64
	ExpYear  int64
}

type Provider interface {
	Name() string

	EnsureCustomer(ctx context.Context, in EnsureCustomerInput) (customerID string, err error)
	CreateCreditsCheckout(ctx context.Context, in CreditsCheckoutInput) (*CheckoutSession, error)
	CreateSetupCheckout(ctx context.Context, in SetupCheckoutInput) (*CheckoutSession, error)

	ParseWebhookEvent(ctx context.Context, headers map[string][]string, body []byte) (*WebhookEvent, error)
	ResolveSetupPaymentMethod(ctx context.Context, setupIntentID string) (*PaymentMethodDetails, error)
}

type SetupCheckoutInput struct {
	CustomerID string
	Username   string

	SuccessURL string
	CancelURL  string
}

type WebhookEvent struct {
	Type    string
	Session CheckoutSession
}