v2 Billing

Refresh subscription from the provider (post-checkout fast plan update)

EP-039-T6. Pulls the provider's CURRENT subscription state server-side (GET /paywall/{id}/user, x-api-key only) and reconciles our DB, then returns the (possibly just-updated) effective plan — so the web app / extension flip to the paid tier immediately after a checkout-success redirect instead of waiting for the webhook. Webhooks remain the source of truth; this only fills gaps (a webhook the provider gave up retrying) and confirms fast. Reachable by a web session OR a device-signed linked device (AccountAuthMiddleware); identity for the read is the account email (or stored monetize_customer_id). Best-effort: a provider read error still returns the stored state. The read never leaves api-facade.

post/api/v2/billing/refresh

Request

  • Base URL: https://pdf2md.dev
  • URL: https://pdf2md.dev/api/v2/billing/refresh
  • Auth: one of:
    • API key in cookie p2m_session
    • HTTP bearer

Response

Effective plan after reconcile

tierstring required

Effective tier after the provider read (free|builder|pro|business|...)

refreshedboolean required

true when the read changed our stored subscription state

Changes

No recorded changes to this operation across all 1 revision of this API.