webhooks

Documentation

Index

• func CanonicalizeHeaders(h http.Header) (canonicalJSON []byte, canonical map[string][]string, err error)
• func ComputeWebhookHashes(method, path string, headersCanonicalJSON []byte, rawBody []byte) (rawBodySHA, headersSHA, requestSHA string)
• type VerificationResult
• type Verifier
  • func NewGenericHMACVerifier(provider string) Verifier
  • func NewStripeV1Verifier(provider string) Verifier
  • func NewStripeV1VerifierWithTolerance(provider string, toleranceSeconds int) Verifier

Functions

func CanonicalizeHeaders

func CanonicalizeHeaders(h http.Header) (canonicalJSON []byte, canonical map[string][]string, err error)

func ComputeWebhookHashes

func ComputeWebhookHashes(method, path string, headersCanonicalJSON []byte, rawBody []byte) (rawBodySHA, headersSHA, requestSHA string)

Types

type VerificationResult

type VerificationResult struct {
	Valid           bool           `json:"valid"`
	Scheme          string         `json:"scheme"`
	Details         map[string]any `json:"details"`
	ProviderEventID string         `json:"provider_event_id,omitempty"`
	EventType       string         `json:"event_type,omitempty"`
}

type Verifier

type Verifier interface {
	Provider() string
	Verify(headers http.Header, rawBody []byte, receivedAt time.Time, secret string) (VerificationResult, error)
}

func NewGenericHMACVerifier

func NewGenericHMACVerifier(provider string) Verifier

func NewStripeV1Verifier

func NewStripeV1Verifier(provider string) Verifier

func NewStripeV1VerifierWithTolerance

func NewStripeV1VerifierWithTolerance(provider string, toleranceSeconds int) Verifier