client

Oct 26, 2026

Changes in this version

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

+ func NewHTTPClient(methods []Method, opts ...Option) (*http.Client, error)

type Option

+ func WithMaxRetries(n int) Option

+ func WithOrderChallenges(fn OrderChallenges) Option

+ type OrderChallenges func(ctx context.Context, candidates []ChallengeCandidate) ([]ChallengeCandidate, error)

+ type OriginValidator interface

+ ValidateOrigin func(origin *url.URL, challenge *mpp.Challenge) error

type Transport

+ func NewHTTPTransport(methods []Method, inner http.RoundTripper, opts ...Option) (*Transport, error)

Oct 26, 2026

Changes in this version

+ type PaymentOutcomeUnknownError struct

+ Challenge *mpp.Challenge

+ Credential *mpp.Credential

+ Err error

+ func (e *PaymentOutcomeUnknownError) Error() string

+ func (e *PaymentOutcomeUnknownError) Timeout() bool

+ func (e *PaymentOutcomeUnknownError) Unwrap() error

Oct 25, 2026

Changes in this version

+ type ChallengeCandidate struct

+ Challenge *mpp.Challenge

+ Method Method

+ Quality float64

+ func SelectChallengeCandidates(challenges []mpp.Challenge, methods []Method, preferences PaymentPreferences) ([]ChallengeCandidate, error)

Oct 25, 2026

Changes in this version

+ type ChallengeMatcher interface

+ CanHandleChallenge func(challenge *mpp.Challenge) bool

type Method

+ Intent func() string

+ type OnChallengeFunc func(ctx context.Context, challenge *mpp.Challenge, ...) (*mpp.Credential, error)

type Option

+ func WithOnChallenge(onChallenge OnChallengeFunc) Option

+ func WithPaymentPreferences(preferences PaymentPreferences) Option

+ func WithTrustedTempoProofRealm(origin, realm string) Option

+ type PaymentPreferences map[string]float64

+ type TransportOption func(*transportConfig)

+ func WithTransportOnChallenge(onChallenge OnChallengeFunc) TransportOption

+ func WithTransportPaymentPreferences(preferences PaymentPreferences) TransportOption

+ func WithTransportTrustedProofRealm(origin, realm string) TransportOption

May 2, 2026

Changes in this version

+ type Client struct

+ func New(methods []Method, opts ...Option) *Client

+ func (c *Client) Do(req *http.Request) (*http.Response, error)

+ func (c *Client) Get(ctx context.Context, url string) (*http.Response, error)

+ func (c *Client) Post(ctx context.Context, url string, contentType string, body io.Reader) (*http.Response, error)

+ type Method interface

+ CreateCredential func(ctx context.Context, challenge *mpp.Challenge) (*mpp.Credential, error)

+ Name func() string

+ type Option func(*Client)

+ func WithHTTPClient(c *http.Client) Option

+ type Transport struct

+ func NewTransport(methods []Method, inner http.RoundTripper) *Transport

+ func (t *Transport) RoundTrip(req *http.Request) (*http.Response, error)