processor

Apr 19, 2026

Changes in this version

type ProcessorType

+ const BitPay

+ const Circle

+ const CoinbaseCommerce

+ const MoonPay

+ const OpenNode

+ const SolanaPay

Mar 2, 2026

Changes in this version

type ProcessorType

+ const Wire

Feb 23, 2026

Changes in this version

type ProcessorType

+ const Adyen

+ const Braintree

+ const LemonSqueezy

+ const Recurly

Feb 23, 2026

Changes in this version

+ var CryptoCurrencies = map[currency.Type]bool

+ var ErrCryptoNotSupported = errors.New("crypto operations not supported by processor")

+ var ErrCurrencyNotSupported = errors.New("currency not supported by processor")

+ var ErrCustomerNotSupported = errors.New("customer management not supported by processor")

+ var ErrInsufficientFunds = errors.New("insufficient funds")

+ var ErrInvalidPaymentRequest = errors.New("invalid payment request")

+ var ErrPaymentDeclined = errors.New("payment declined")

+ var ErrPaymentFailed = errors.New("payment failed")

+ var ErrProcessorDisabled = errors.New("payment processor is disabled")

+ var ErrProcessorNotAvailable = errors.New("payment processor not available")

+ var ErrProcessorNotFound = errors.New("payment processor not found")

+ var ErrRefundFailed = errors.New("refund failed")

+ var ErrSigningFailed = errors.New("signing ceremony failed")

+ var ErrSubscriptionNotSupported = errors.New("subscriptions not supported by processor")

+ var ErrThresholdNotMet = errors.New("signing threshold not met")

+ var ErrTransactionNotFound = errors.New("transaction not found")

+ var ErrWebhookValidationFailed = errors.New("webhook validation failed")

+ func CommonCryptoCurrencies() []currency.Type

+ func CommonFiatCurrencies() []currency.Type

+ func IsCryptoCurrency(c currency.Type) bool

+ func Register(p PaymentProcessor)

+ func SupportsCurrency(p PaymentProcessor, c currency.Type) bool

+ func ValidateRequest(req PaymentRequest) error

+ type Balance struct

+ Available currency.Cents

+ Currency currency.Type

+ Pending currency.Cents

+ type BaseProcessor struct

+ func NewBaseProcessor(t ProcessorType, currencies []currency.Type) *BaseProcessor

+ func (b *BaseProcessor) Authorize(ctx context.Context, req PaymentRequest) (*PaymentResult, error)

+ func (b *BaseProcessor) Capture(ctx context.Context, transactionID string, amount currency.Cents) (*PaymentResult, error)

+ func (b *BaseProcessor) IsAvailable(ctx context.Context) bool

+ func (b *BaseProcessor) SetConfigured(configured bool)

+ func (b *BaseProcessor) SupportedCurrencies() []currency.Type

+ func (b *BaseProcessor) Type() ProcessorType

+ type CryptoProcessor interface

+ EstimateFee func(ctx context.Context, req PaymentRequest) (currency.Cents, error)

+ GenerateAddress func(ctx context.Context, customerID string, chain string) (string, error)

+ GetBalance func(ctx context.Context, address string, chain string) (*Balance, error)

+ SupportedChains func() []string

+ type CustomerProcessor interface

+ AddPaymentMethod func(ctx context.Context, customerID, token string) (string, error)

+ CreateCustomer func(ctx context.Context, email, name string, metadata map[string]interface{}) (string, error)

+ DeleteCustomer func(ctx context.Context, customerID string) error

+ GetCustomer func(ctx context.Context, customerID string) (map[string]interface{}, error)

+ RemovePaymentMethod func(ctx context.Context, customerID, paymentMethodID string) error

+ UpdateCustomer func(ctx context.Context, customerID string, updates map[string]interface{}) error

+ type PaymentError struct

+ Code string

+ Err error

+ Message string

+ Processor ProcessorType

+ func NewPaymentError(processor ProcessorType, code, message string, err error) *PaymentError

+ func (e *PaymentError) Error() string

+ func (e *PaymentError) Unwrap() error

+ type PaymentProcessor interface

+ Authorize func(ctx context.Context, req PaymentRequest) (*PaymentResult, error)

+ Capture func(ctx context.Context, transactionID string, amount currency.Cents) (*PaymentResult, error)

+ Charge func(ctx context.Context, req PaymentRequest) (*PaymentResult, error)

+ GetTransaction func(ctx context.Context, txID string) (*Transaction, error)

+ IsAvailable func(ctx context.Context) bool

+ Refund func(ctx context.Context, req RefundRequest) (*RefundResult, error)

+ SupportedCurrencies func() []currency.Type

+ Type func() ProcessorType

+ ValidateWebhook func(ctx context.Context, payload []byte, signature string) (*WebhookEvent, error)

+ func Get(t ProcessorType) (PaymentProcessor, error)

+ func SelectProcessor(ctx context.Context, req PaymentRequest) (PaymentProcessor, error)

+ type PaymentRequest struct

+ Address string

+ Amount currency.Cents

+ Chain string

+ Currency currency.Type

+ CustomerID string

+ Description string

+ Metadata map[string]interface{}

+ Options map[string]interface{}

+ OrderID string

+ Token string

+ type PaymentResult struct

+ Error error

+ ErrorMessage string

+ Fee currency.Cents

+ Metadata map[string]interface{}

+ ProcessorRef string

+ Status string

+ Success bool

+ TransactionID string

+ type ProcessorType string

+ const Bitcoin

+ const Ethereum

+ const MPC

+ const PayPal

+ const Square

+ const Stripe

+ type RefundRequest struct

+ Amount currency.Cents

+ Metadata map[string]interface{}

+ Reason string

+ TransactionID string

+ type RefundResult struct

+ Error error

+ ErrorMessage string

+ ProcessorRef string

+ RefundID string

+ Success bool

+ type Registry struct

+ func Global() *Registry

+ func NewRegistry(config *RegistryConfig) *Registry

+ func (r *Registry) Available(ctx context.Context) []PaymentProcessor

+ func (r *Registry) DisableProcessor(t ProcessorType)

+ func (r *Registry) EnableProcessor(t ProcessorType)

+ func (r *Registry) Get(t ProcessorType) (PaymentProcessor, error)

+ func (r *Registry) GetCrypto(t ProcessorType) (CryptoProcessor, error)

+ func (r *Registry) GetCustomer(t ProcessorType) (CustomerProcessor, error)

+ func (r *Registry) GetSubscription(t ProcessorType) (SubscriptionProcessor, error)

+ func (r *Registry) ListTypes() []ProcessorType

+ func (r *Registry) Register(p PaymentProcessor)

+ func (r *Registry) SelectProcessor(ctx context.Context, req PaymentRequest) (PaymentProcessor, error)

+ func (r *Registry) SelectSubscriptionProcessor(ctx context.Context, req PaymentRequest) (SubscriptionProcessor, error)

+ func (r *Registry) SetConfig(config *RegistryConfig)

+ func (r *Registry) Unregister(t ProcessorType)

+ type RegistryConfig struct

+ DefaultCryptoProcessor ProcessorType

+ DefaultFiatProcessor ProcessorType

+ DisabledProcessors map[ProcessorType]bool

+ ProcessorPriority []ProcessorType

+ func DefaultConfig() *RegistryConfig

+ type Subscription struct

+ CancelAtPeriodEnd bool

+ CurrentPeriodEnd int64

+ CurrentPeriodStart int64

+ CustomerID string

+ ID string

+ Metadata map[string]interface{}

+ PlanID string

+ Status string

+ type SubscriptionProcessor interface

+ CancelSubscription func(ctx context.Context, subscriptionID string, immediately bool) error

+ CreateSubscription func(ctx context.Context, req SubscriptionRequest) (*Subscription, error)

+ GetSubscription func(ctx context.Context, subscriptionID string) (*Subscription, error)

+ ListSubscriptions func(ctx context.Context, customerID string) ([]*Subscription, error)

+ UpdateSubscription func(ctx context.Context, subscriptionID string, req SubscriptionUpdate) (*Subscription, error)

+ type SubscriptionRequest struct

+ CustomerID string

+ Metadata map[string]interface{}

+ PaymentToken string

+ PlanID string

+ Quantity int

+ TrialDays int

+ type SubscriptionUpdate struct

+ CancelAtPeriodEnd *bool

+ PlanID string

+ Quantity int

+ type Transaction struct

+ Amount currency.Cents

+ CreatedAt int64

+ Currency currency.Type

+ CustomerID string

+ Fee currency.Cents

+ ID string

+ Metadata map[string]interface{}

+ ProcessorRef string

+ Status string

+ Type string

+ UpdatedAt int64

+ type WebhookEvent struct

+ Data map[string]interface{}

+ ID string

+ Processor ProcessorType

+ Timestamp int64

+ Type string