dcc4bd0d10
This change enables the freezing/warning of users who use storjscan. Issue: https://github.com/storj/storj/issues/6164 Change-Id: I7b00ee09d6527b3818b72326e9065c82ef5a2ac8
94 lines
3.3 KiB
Go
94 lines
3.3 KiB
Go
// Copyright (C) 2019 Storj Labs, Inc.
|
|
// See LICENSE for copying information.
|
|
|
|
package payments
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
|
|
"storj.io/common/uuid"
|
|
)
|
|
|
|
const (
|
|
// InvoiceStatusDraft indicates the invoice is a draft.
|
|
InvoiceStatusDraft = "draft"
|
|
// InvoiceStatusOpen indicates the invoice is open.
|
|
InvoiceStatusOpen = "open"
|
|
// InvoiceStatusPaid indicates the invoice is paid.
|
|
InvoiceStatusPaid = "paid"
|
|
// InvoiceStatusUncollectible indicates the invoice is uncollectible.
|
|
InvoiceStatusUncollectible = "uncollectible"
|
|
// InvoiceStatusVoid indicates the invoice is void.
|
|
InvoiceStatusVoid = "void"
|
|
)
|
|
|
|
// Invoices exposes all needed functionality to manage account invoices.
|
|
//
|
|
// architecture: Service
|
|
type Invoices interface {
|
|
// Create creates an invoice with price and description.
|
|
Create(ctx context.Context, userID uuid.UUID, price int64, desc string) (*Invoice, error)
|
|
// Get returns an invoice by invoiceID.
|
|
Get(ctx context.Context, invoiceID string) (*Invoice, error)
|
|
// Pay pays an invoice.
|
|
Pay(ctx context.Context, invoiceID, paymentMethodID string) (*Invoice, error)
|
|
// List returns a list of invoices for a given payment account.
|
|
List(ctx context.Context, userID uuid.UUID) ([]Invoice, error)
|
|
// ListPaged returns a paged list of invoices.
|
|
ListPaged(ctx context.Context, userID uuid.UUID, cursor InvoiceCursor) (*InvoicePage, error)
|
|
// ListFailed returns a list of failed invoices.
|
|
ListFailed(ctx context.Context, userID *uuid.UUID) ([]Invoice, error)
|
|
// ListWithDiscounts returns a list of invoices and coupon usages for a given payment account.
|
|
ListWithDiscounts(ctx context.Context, userID uuid.UUID) ([]Invoice, []CouponUsage, error)
|
|
// CheckPendingItems returns if pending invoice items for a given payment account exist.
|
|
CheckPendingItems(ctx context.Context, userID uuid.UUID) (existingItems bool, err error)
|
|
// AttemptPayOverdueInvoices attempts to pay a user's open, overdue invoices.
|
|
AttemptPayOverdueInvoices(ctx context.Context, userID uuid.UUID) (err error)
|
|
// AttemptPayOverdueInvoicesWithTokens attempts to pay a user's open, overdue invoices with token only.
|
|
AttemptPayOverdueInvoicesWithTokens(ctx context.Context, userID uuid.UUID) (err error)
|
|
// Delete a draft invoice.
|
|
Delete(ctx context.Context, id string) (inv *Invoice, err error)
|
|
}
|
|
|
|
// Invoice holds all public information about invoice.
|
|
type Invoice struct {
|
|
ID string `json:"id"`
|
|
CustomerID string `json:"-"`
|
|
Description string `json:"description"`
|
|
Amount int64 `json:"amount"`
|
|
Status string `json:"status"`
|
|
Link string `json:"link"`
|
|
Start time.Time `json:"start"`
|
|
End time.Time `json:"end"`
|
|
}
|
|
|
|
// InvoiceCursor holds info for invoices
|
|
// cursor pagination.
|
|
type InvoiceCursor struct {
|
|
Limit int
|
|
|
|
// StartingAfter is the last invoice ID of the previous page.
|
|
// The next page will start after this ID.
|
|
StartingAfter string
|
|
// EndingBefore is the id before which a page should end.
|
|
EndingBefore string
|
|
}
|
|
|
|
// InvoicePage returns paginated invoices.
|
|
type InvoicePage struct {
|
|
Invoices []Invoice
|
|
// Next indicates whether there are more events to retrieve.
|
|
Next bool
|
|
// Previous indicates whether there are previous items.
|
|
Previous bool
|
|
}
|
|
|
|
// CouponUsage describes the usage of a coupon on an invoice.
|
|
type CouponUsage struct {
|
|
Coupon Coupon
|
|
Amount int64
|
|
PeriodStart time.Time
|
|
PeriodEnd time.Time
|
|
}
|