Async webhook delivery​

Webhook processing is now fully asynchronous. Previously, slow endpoints could cause delivery delays across your account. With async delivery, each webhook is dispatched independently — a slow endpoint doesn't affect others.

What changed:

• Delivery is decoupled from the triggering API call
• Latency is reduced by ~40ms on average for high-volume accounts
• Delivery status is visible in the Dashboard in real time

No changes required to your endpoint or integration.

Dead-letter queues​

Failed webhooks (after all retry attempts) are now placed in a dead-letter queue instead of being silently dropped.

You can inspect and replay dead-lettered events from the Dashboard under Developers → Webhooks → Dead Letter Queue, or via the new API endpoint:

# List dead-lettered events
curl https://api.meridian.dev/v1/webhook_endpoints/we_123/dead_letter \
  -u sk_test_4eC39HqL...:

# Replay a specific event
curl -X POST https://api.meridian.dev/v1/webhook_endpoints/we_123/dead_letter/evt_456/replay \
  -u sk_test_4eC39HqL...:

New SDK methods​

Node.js / Python / Ruby​

• meridian.webhooks.constructEventAsync() — async-compatible version of constructEvent
• meridian.customers.search() — search customers by email, name, or metadata
• meridian.paymentIntents.incrementAuthorization() — increase an authorized amount before capture

Go​

• client.PaymentIntents.IncrementAuthorization() added
• Context propagation is now consistent across all methods

Breaking changes​

None. This release is fully backwards-compatible.

Deprecations​

• webhook_endpoint.secret is now returned only on creation, not on subsequent retrieves. Store your secret at creation time.

View the full API changelog →

Subscription pausing​

You can now pause and resume subscriptions without canceling them. Pausing stops billing cycles — no invoice is generated during the pause period.

# Pause a subscription
curl https://api.meridian.dev/v1/subscriptions/sub_123 \
  -u sk_test_4eC39HqL...: \
  -d "pause_collection[behavior]"=void

# Resume
curl https://api.meridian.dev/v1/subscriptions/sub_123 \
  -u sk_test_4eC39HqL...: \
  -d pause_collection=

Two pause behaviors are supported:

• void — Invoice is voided; customer is not charged for the pause period
• keep_as_draft — Invoice stays as a draft; customer is charged when resumed

Invoice draft mode (GA)​

Invoice drafts launched in beta in v2.2. In v2.3, draft mode is now generally available and recommended for all invoice workflows.

Create invoices in draft mode, add line items, then finalize when ready:

// Create draft
const invoice = await meridian.invoices.create({
  customer: 'cus_123',
  auto_advance: false,   // stays as draft
});

// Add line items
await meridian.invoiceItems.create({
  customer: 'cus_123',
  invoice: invoice.id,
  amount: 4999,
  currency: 'usd',
  description: 'Enterprise seat – April',
});

// Finalize and send
await meridian.invoices.finalizeInvoice(invoice.id);
await meridian.invoices.sendInvoice(invoice.id);

Test Clocks (GA)​

Test Clocks — introduced in beta in v2.1 — are now generally available. Use them to simulate the passage of time in test mode without waiting for real time to pass.

See the Test Mode docs for usage examples.

Other improvements​

• Customer objects now include balance (in cents) representing prepaid credit or outstanding debt
• Invoice.paid_out_of_band flag for marking invoices paid outside Meridian (e.g., wire transfer)
• Rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) added to all responses