customer

Documentation

Index

• Variables
• func GetStripeTestClockFromContext(ctx context.Context) (string, bool)
• func SetStripeTestClockInContext(ctx context.Context, s string) context.Context
• type Address
• type Customer
• type Filter
• type OrgService
• type PaymentMethod
• type Provider
• type Repository
• type Service
  • func NewService(stripeClient *client.API, repository Repository, orgService OrgService) *Service
  • func (s Service) Create(ctx context.Context, customer Customer) (Customer, error)
  • func (s Service) Delete(ctx context.Context, id string) error
  • func (s Service) GetByID(ctx context.Context, id string) (Customer, error)
  • func (s Service) GetByOrgID(ctx context.Context, orgID string) (Customer, error)
  • func (s Service) List(ctx context.Context, filter Filter) ([]Customer, error)
  • func (s Service) ListPaymentMethods(ctx context.Context, id string) ([]PaymentMethod, error)
  • func (s Service) Update(ctx context.Context, customer Customer) (Customer, error)

Variables

var (
	ErrNotFound      = errors.New("customer not found")
	ErrInvalidUUID   = errors.New("invalid syntax of uuid")
	ErrInvalidID     = errors.New("billing customer id is invalid")
	ErrConflict      = errors.New("customer already exist")
	ErrInvalidDetail = errors.New("invalid billing customer detail")
	ErrDisabled      = errors.New("billing customer is disabled")
)

Functions

func GetStripeTestClockFromContext

func GetStripeTestClockFromContext(ctx context.Context) (string, bool)

GetStripeTestClockFromContext returns the stripe test clock id from the context

func SetStripeTestClockInContext

func SetStripeTestClockInContext(ctx context.Context, s string) context.Context

SetStripeTestClockInContext sets the stripe test clock id in the context

Types

type Address

type Address struct {
	City       string `json:"city"`
	Country    string `json:"country"`
	Line1      string `json:"line1"`
	Line2      string `json:"line2"`
	PostalCode string `json:"postal_code"`
	State      string `json:"state"`
}

type Customer

type Customer struct {
	ID         string
	OrgID      string
	ProviderID string // identifier set by the billing engine provider

	Name    string
	Email   string
	Phone   string
	Address Address
	// Currency Three-letter ISO 4217 currency code in lower case
	Currency string `default:"usd"`
	Metadata metadata.Metadata

	// Stripe specific fields
	// StripeTestClockID is used for testing purposes only to simulate a subscription
	StripeTestClockID *string

	State     string
	CreatedAt time.Time
	UpdatedAt time.Time
	DeletedAt *time.Time
}

type Filter

type Filter struct {
	OrgID string
}

type OrgService

type OrgService interface {
	Get(ctx context.Context, id string) (organization.Organization, error)
}

type PaymentMethod

type PaymentMethod struct {
	ID         string
	CustomerID string
	ProviderID string
	Type       string

	CardLast4       string
	CardBrand       string
	CardExpiryYear  int64
	CardExpiryMonth int64

	Metadata  metadata.Metadata
	CreatedAt time.Time
}

type Provider

type Provider string

const (
	ProviderStripe Provider = "stripe"
)

type Repository

type Repository interface {
	GetByID(ctx context.Context, id string) (Customer, error)
	List(ctx context.Context, filter Filter) ([]Customer, error)
	Create(ctx context.Context, customer Customer) (Customer, error)
	UpdateByID(ctx context.Context, customer Customer) (Customer, error)
	Delete(ctx context.Context, id string) error
}

type Service

type Service struct {
	// contains filtered or unexported fields
}

func NewService

func NewService(stripeClient *client.API, repository Repository, orgService OrgService) *Service

func (Service) Create

func (s Service) Create(ctx context.Context, customer Customer) (Customer, error)

func (Service) Delete

func (s Service) Delete(ctx context.Context, id string) error

func (Service) GetByID

func (s Service) GetByID(ctx context.Context, id string) (Customer, error)

func (Service) GetByOrgID

func (s Service) GetByOrgID(ctx context.Context, orgID string) (Customer, error)

func (Service) List

func (s Service) List(ctx context.Context, filter Filter) ([]Customer, error)

func (Service) ListPaymentMethods

func (s Service) ListPaymentMethods(ctx context.Context, id string) ([]PaymentMethod, error)

func (Service) Update

func (s Service) Update(ctx context.Context, customer Customer) (Customer, error)