Skip to content
Paylera

Changelog

The changelog tracks both API versions (dated, semver-like) and platform updates (additive, non-breaking).

The API changelog policy is in Versioning.

2026-04-01 (current)

New

  • POST /v1/checkout/sessions now accepts line_items to override plan pricing per session.
  • New event: subscription.commitment_ending (T-30 days).
  • GET /v1/subscriptions/{id}/upcoming-invoice is now public (was preview).

Behavioural

  • Provider-hint-driven dunning now defaults to true (previously false). Recovery rates improved 8–15% in measurement.
  • Webhook signing window tightened from 10 minutes to 5 minutes for replay protection. Update your handler’s tolerance if you set it explicitly.

Breaking (versus previous version)

  • payment.last_error.is_retriable replaces the deprecated last_error.retriable. Both fields shipped together for one version.
  • invoice.payments now returns IDs as strings; previously it was an inconsistent mix of objects and strings depending on expansion.

2025-10-01

New

  • Wallets: per-customer prepaid balances. New endpoints under /v1/wallets. New events: wallet.*.
  • POST /v1/portal/sessions for customer portal.
  • late_events: rebill for usage components.

Behavioural

  • Idempotency key TTL extended from 12 hours to 24 hours.
  • Paylera-Beta: hosted-checkout-2 graduates to GA; the header is now a no-op.

2025-04-01

New

  • Subscription commitments (commitment.* fields).
  • Multi-currency: presentment_currency and settlement_currency on invoices.
  • Affiliates module: /v1/affiliates, /v1/payouts/batches.

Breaking (versus 2024-10-01)

  • invoice.tax is now always present (was optional). Pre-existing invoices have tax: "0.00" filled in.
  • Webhook signature header renamed from X-Paylera-Signature to Paylera-Signature. Old header continued to be sent for 12 months; removal is in this version.

Platform updates (additive)

These don’t change the API contract; they add capability or improve operations. No version pin needed.

2026-04-15

  • Status page UI redesigned. RSS feed unchanged.
  • New region: apac (ap-southeast-2). Available for new tenants.

2026-04-08

  • Tax engine: TaxJar now supported alongside Stripe Tax and Avalara.
  • CLI v0.18: paylera trigger accepts --from-fixture path/to/file.json.

2026-03-22

  • SOC 2 Type II report for the Aug 2025 – Feb 2026 audit window available under NDA.
  • Dashboard: new “Cohort waterfall” chart on the Revenue page.

2026-03-01

  • New SDK: Python (paylera) — beta.
  • Bulk replay: POST /v1/admin/webhook-endpoints/{id}/replay now supports up to 7-day windows (was 24h).

Subscribe to changes

  • RSS: https://docs.paylera.io/changelog.rss.
  • Webhook: subscribe to the paylera.* system events on any endpoint to be notified of platform-level updates.
  • Email: opt in via the dashboard at Settings → Notifications.

Reading the format

  • New — additions. Non-breaking; available immediately at the named version.
  • Behavioural — non-shape changes (defaults, timeouts, rounding) that may affect observable behaviour. Read these.
  • Breaking — shape changes. Pin the prior version until you’ve migrated.