payment

Jul 16, 2026

Changes in this version

type Provider

+ func ParseProvider(name string) (Provider, error)

Jul 13, 2026

Changes in this version

type Provider

+ const ProviderMock

Jul 13, 2026

Changes in this version

+ var ErrExpired = errors.New("payment: expired")

+ var ErrGateway = errors.New("payment: gateway error")

+ var ErrInvalidConfig = errors.New("payment: invalid config")

+ var ErrInvalidOAuthState = errors.New("payment: invalid oauth state")

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

+ var ErrInvalidSignature = errors.New("payment: invalid signature")

+ var ErrUnknownStatus = errors.New("payment: unknown status")

+ var ErrUnsupportedClient = errors.New("payment: unsupported client")

+ func ValidateContext(ctx context.Context) error

+ type JSAPIResult struct

+ AppID string

+ NonceStr string

+ Package string

+ PaySign string

+ SignType string

+ Timestamp string

+ type NotifyResponse struct

+ Body []byte

+ ContentType string

+ StatusCode int

+ func (r NotifyResponse) WriteTo(w http.ResponseWriter) error

type Order

+ ExpireAt *time.Time

+ type PaymentNotification struct

+ Amount int64

+ Extra map[string]any

+ OrderID string

+ PaidAt *time.Time

+ Provider Provider

+ Status PaymentStatus

+ TransactionID string

+ type PaymentNotifier interface

+ ParsePaymentNotification func(ctx context.Context, req *http.Request) (*PaymentNotification, error)

+ SuccessResponse func() NotifyResponse

type PaymentStatus

+ const PaymentStatusRefunded

+ type Provider string

+ const ProviderAlipay

+ const ProviderWechat

+ type ProviderError struct

+ Code string

+ Err error

+ Message string

+ Operation string

+ Provider Provider

+ func (e *ProviderError) Error() string

+ func (e *ProviderError) Unwrap() error

+ type RefundNotification struct

+ Amount int64

+ Extra map[string]any

+ OrderID string

+ Provider Provider

+ ProviderRefundID string

+ RefundAt *time.Time

+ RefundID string

+ Status RefundStatus

+ TransactionID string

+ type RefundNotifier interface

+ ParseRefundNotification func(ctx context.Context, req *http.Request) (*RefundNotification, error)

+ SuccessResponse func() NotifyResponse

type RefundRequest

+ OriginalAmount int64

type RefundResult

+ TransactionID string

type RefundStatus

+ const RefundStatusClosed

+ type WAPResult struct

+ URL string

May 17, 2026

Changes in this version

+ var ErrNotImplemented = errors.New("payment adapter is not implemented")

Apr 13, 2026

Changes in this version

+ func ValidateOrder(order *Order) error

+ func ValidateOrderID(orderID string) error

+ func ValidateRefundRequest(req *RefundRequest) error

+ type Order struct

+ Amount int64

+ Description string

+ Extra map[string]any

+ NotifyURL string

+ OrderID string

+ ReturnURL string

+ Subject string

+ type Payment interface

+ Close func(orderID string) error

+ Pay func(order *Order) (*PaymentResult, error)

+ Query func(orderID string) (*QueryResult, error)

+ Refund func(req *RefundRequest) (*RefundResult, error)

+ type PaymentResult struct

+ Extra map[string]any

+ OrderID string

+ PayURL string

+ TransactionID string

+ type PaymentStatus string

+ const PaymentStatusClosed

+ const PaymentStatusFailed

+ const PaymentStatusPending

+ const PaymentStatusSuccess

+ type QueryResult struct

+ Amount int64

+ OrderID string

+ PaidAt *time.Time

+ Status PaymentStatus

+ TransactionID string

+ type RefundRequest struct

+ Amount int64

+ NotifyURL string

+ OrderID string

+ Reason string

+ RefundID string

+ type RefundResult struct

+ RefundAt *time.Time

+ RefundID string

+ Status RefundStatus

+ type RefundStatus string

+ const RefundStatusFailed

+ const RefundStatusPending

+ const RefundStatusSuccess