Source
Payment collection, dunning & portability — found from sitemap — Metronome
Checked for Metronome on 10 Nov 2026
- Page
- https://docs.metronome.com/guides/pricing-packaging/subscription/payment-gate-subscriptions
- Checked
- 10 Nov 2026, 11:48 UTC
- How we may use it
- Public page, crawling permitted
Technical details
- type
- page
- http status
- 200
- content hash
- sha256:7dbd4ad495f5274ded2bfb6ec3bb678c775f7856c7e4315fcccff157a5646859
- permission
- robots_ok
- screenshot
- Screenshot on file (internal exhibit, not published)
Cited by
Facts read from this source
-
Payment gated subscriptions Report an error
“This page describes how to require payment before granting access to a subscription or its recurring credits. Payment gating lets Metronome track the paid subscription quantity, release attached credits according to payment status, and notify your application when the entitlement state changes.”
-
Payment gated preview status Report an error
“This page documents a private preview. Contact your Metronome representative to confirm access before using these provisional fields and endpoints.”
-
Payment gate stripe only Report an error
“Payment-gated subscriptions currently support only Stripe Invoicing.”
-
Payment gate webhook Report an error
“Metronome sends subscription.payment_gate_status whenever the paid quantity, subscription status, or external invoice is updated, except for the transition to ENDED.”
-
Credit access policies Report an error
“BILLING_PERIOD_PAID Metronome releases each period’s credits after payment for that period succeeds. The initial payment and every renewal gate their corresponding credits.”
-
Subscription statuses Report an error
“NOT_STARTED The subscription hasn’t reached its start date or its initial payment hasn’t completed.”
-
Status incomplete Report an error
“INCOMPLETE The initial subscription payment failed. No new invoices will be generated and subscription quantity cannot be changed.”
-
Status unpaid Report an error
“UNPAID A recurring subscription payment failed. If subscription is not ended, renewal invoices will continue to be generated, but subscription quantity cannot be changed.”
-
Status active Report an error
“ACTIVE The latest subscription-cycle payment succeeded. Pending quantity increases don’t change the paid quantity until payment succeeds.”
-
Quantity change rollback Report an error
“If a pending quantity change is not paid within one hour, Metronome automatically rolls back the quantity change and voids the corresponding invoices.”
-
One pending quantity change Report an error
“Only one quantity change can be pending for a subscription at a time.”
-
Get subscription status API Report an error
“Use the getSubscriptionStatus API to programmatically view subscription state, reconcile entitlements, or check whether a payment is still pending.”
-
Payment window days Report an error
“Initial and renewal invoices have a 13-day payment window to accommodate payment methods such as ACH and give you time to handle payment recovery.”
-
Invoice expiration Report an error
“If payment doesn’t succeed within 13 days, Metronome automatically voids the Stripe invoice, which also voids the corresponding Metronome invoice. All open invoices expire at the end of their billing period, even if the 13-day window hasn’t elapsed.”
-
Stripe smart retries Report an error
“Your Stripe payment recovery settings, including Smart Retries, continue to apply automatically while the invoice remains open.”
-
Stripe webhooks required Report an error
“Listen to Stripe invoice and PaymentIntent webhooks to handle detailed payment failures and customer actions such as 3DS authentication.”
-
Lifecycle events Report an error
“Lifecycle events aren’t enabled automatically. Enable them for your webhook destination. An ENDED subscription doesn’t produce a subscription.payment_gate_status event.”
-
Preview quantity only Report an error
“Quantity-based subscriptions only. Seat-based subscriptions that track individual seat IDs aren’t supported yet.”
-
Preview billing requirements Report an error
“Payment gated subscriptions must be billed in-advance (collection_schedule: "advance") and quantity updates billed immediately (proration.invoice_behavior: "bill_immediately").”
-
Preview tax systems Report an error
“Stripe Tax and Stripe Invoicing are the only supported downstream tax and invoicing systems.”
-
Stripe customer requirements Report an error
“Ensure that each Stripe customer has a default payment method and a valid stored customer address. Without these, payment attempts fail.”
-
Entitlement model Report an error
“Treat Metronome as the source of truth for entitlement state and Stripe as the source of truth for payment actions.”
Scores citing this record
- The Billing Engineer Cross-border VAT & tax handling
- The Billing Engineer Payment collection, dunning & portability
- The Finance Lead Plans, pricing models & subscription lifecycle
- The Finance Lead Invoices & e-invoicing compliance
- The Finance Lead Cross-border VAT & tax handling
- The Finance Lead Payment collection, dunning & portability
- The Finance Lead European sovereignty
- The Finance Lead Pricing transparency
- The SaaS Founder Plans, pricing models & subscription lifecycle
- The SaaS Founder Invoices & e-invoicing compliance
- The SaaS Founder Cross-border VAT & tax handling
- The SaaS Founder Payment collection, dunning & portability
- The SaaS Founder Pricing transparency
- The Service-Business Owner Plans, pricing models & subscription lifecycle
- The Service-Business Owner Invoices & e-invoicing compliance
- The Service-Business Owner Cross-border VAT & tax handling
- The Service-Business Owner Payment collection, dunning & portability
- The Service-Business Owner European sovereignty
- The Service-Business Owner Pricing transparency
- The Skeptic Plans, pricing models & subscription lifecycle
- The Skeptic Invoices & e-invoicing compliance
- The Skeptic Cross-border VAT & tax handling
- The Skeptic Payment collection, dunning & portability
- The Skeptic European sovereignty
- The Skeptic Pricing transparency
- The Tax Adviser Plans, pricing models & subscription lifecycle
- The Tax Adviser Invoices & e-invoicing compliance
- The Tax Adviser Cross-border VAT & tax handling
- The Tax Adviser Payment collection, dunning & portability
- The Tax Adviser Pricing transparency