Skip to main content

Payment Provider Unavailable

Reference · Errors

payment_provider_unavailable503

Billing · Billing endpoints

The payment provider (Dodo) could not be reached or is not set up for this account. Nothing changed; try again shortly.

What this means​

A dashboard billing action needed Dodo, our payment provider, and could not use it. We return HTTP 503. Your plan, keys and limits are unchanged.

When you'll see this​

  • Dodo answered with a 5xx error or refused our credentials (HTTP 401).
  • The call to Dodo failed before an answer, for example a network failure.
  • Payments are switched off on our side.
  • Your subscription has no link to a Dodo subscription, so it cannot be upgraded, cancelled, resumed or given a new card. This one needs support.
  • Cancelling or resuming the plan failed at Dodo.
  • Account deletion could not cancel the paid plan at Dodo first. The account is not scheduled for deletion until it can.
Learn more about how this works

Asterwise never charges you itself: subscribing, upgrading, cancelling, resuming, updating the card and listing payments all go through Dodo. When Dodo cannot be used, the action stops before anything is changed on our side and returns 503 so it is clear the cause is the provider.

Example response​

{
  "success": false,
  "error": "payment_provider_unavailable",
  "message": "Payment provider is temporarily unavailable. Please try again shortly.",
  "details": [],
  "retry_after": null,
  "doc_url": "https://docs.asterwise.com/reference/errors/payment_provider_unavailable/",
  "request_id": "req_01HXYZABCDEFGH",
  "timestamp": "2026-05-25T12:34:56Z"
}
NEW TO APIS?
Quick fix
  1. Wait a few minutes and try again from asterwise.com/dashboard.
  2. Check status.asterwise.com.
  3. If the message says your subscription is not linked to the payment provider, or the error lasts more than an hour, email [email protected] with the request_id.
PRODUCTION ENGINEER
Recovery pattern

Only the dashboard receives this error: billing actions need a dashboard sign-in, and an API key sent to the billing endpoints gets session_required instead. Calls to astrology endpoints with an API key do not depend on the payment provider and keep working during a Dodo outage.

Production handler​

No code example provided.

Avoid this error by​

  • Provider outages cannot be prevented; retry later.
  • If the error says the subscription is not linked, contact support rather than retrying.