Authenticate with the Recharge API using an API token scoped to your store — use the `X-Recharge-Access-Token` header on all requests.
To view or update dunning settings for your store, use the Recharge API store settings endpoints (verify endpoint paths in current Recharge API docs, as they differ between Recharge v1 and v2/Schematics).
Configure the payment retry schedule by updating the number of retry attempts and intervals between attempts (typically in days) via the store settings or dunning configuration endpoint.
Set up email notifications for failed charges by configuring Recharge's built-in dunning email templates in the Recharge merchant portal, or by listening to the `charge/failed` webhook and triggering your own email flow.
Subscribe to Recharge webhook topics for `charge/failed`, `charge/max_retries_reached`, and `subscription/deactivated` to detect when dunning exhausts retries and a subscription is cancelled.
Test dunning behavior in the Recharge test environment (sandbox or test mode) by using test card numbers that trigger declines.
Known gotchas
Recharge has two distinct API versions (legacy v1 and the newer Schematics/v2 architecture) with different endpoint structures and authentication flows. Verify which version your store is on before building integrations — some features are unavailable or work differently across versions.
Recharge's built-in retry schedule operates independently from any custom retry logic you implement via webhooks. Running both in parallel can result in double-retry attempts. Choose one approach and disable the other.
When Recharge marks a subscription as `cancelled` due to max retries reached, the subscription cannot be automatically reactivated by re-running a charge — the customer must go through a re-subscribe flow. Account for this in your dunning outcome handling.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp