Trigger
payment.failed
YDbilling module
Failed Payment Recovery
Automatically retry failed card charges, notify the customer, and capture updated payment methods. Recover involuntary churn from expired or declined cards.
The pain this solves
Recover involuntary churn from expired or declined cards. The workflow exists to remove a repeated operational leak: a missed response, delayed follow-up, manual handoff, billing drag, review friction, or retention gap.
What it does
retry schedule, send update card link, notify owner, pause service if applicable
Success metrics
failed payment recovery rate, involuntary churn rate
Functional workflow contract
- Input: payment attempt
- Input: invoice record
- Input: contact record
- Action: retry schedule
- Action: send update card link
- Action: notify owner
- Action: pause service if applicable
- Setting: Retry schedule (days)
- Setting: Pause service after N days
- Setting: Grace amount (USD)
Traceability
| Catalog code | payment_recovery |
|---|---|
| API record | /api/catalog/modules?code=payment_recovery |
| Activation API | POST /api/tenants/activate-module with module_code=payment_recovery |
| Required capabilities | payments, invoicing, crm, email |
| Compliance guards | email_footer, pci_hand_off, fdcpa_b2b_tone_guard |
| Status | spec · guided activation |
If a tenant lacks entitlement or required capabilities, activation returns a typed deferred state rather than pretending the workflow is live.
Recommended for
office-managerowner-operatormed-spacleaningpest-control
What ships behind the promise
This marketplace page is not standalone brochure copy. Every activated item belongs to the same business-unit standard: catalog traceability, tenant entitlement checks, capability checks, event logs, workflow state, internal provider interfaces, optional PostHog analytics, AI/MCP tool metadata, central configuration, build repair telemetry, and resumable checkpoints.
Traceable activation
Each promise maps back to catalog data, API records, activation routes, capability requirements, and deferred states when a tenant is not ready.
Self-hostable core
Core logic uses internal interfaces for payments, email, storage, analytics, documents, AI, signatures, and notifications. External services stay optional adapters.
AI and MCP ready
Generated builds include tool-registry evidence, permissions, workflow definitions, prompt assets, retrieval scaffolding, and model routing guidance.
Repairable build pipeline
Failed build classes feed into detector/remediator pairs, BUILD-REPORT telemetry, and resume checkpoints so future builds continue from the last verified state.
Media and analytics expansion
When enabled, video asset planning and PostHog-ready event tracking connect marketing content to product, funnel, revenue, and customer lifecycle metrics.
Niche validation
Content, offers, workflows, pricing, contracts, and support language are checked against the niche, buyer, location, business model, and primary offer.