Skip to main content
The Router normally pays a merchant from your money: a Delegation caps the spend and your wallet or card funds it. Nevermined credits are the other way to pay. When your agent calls a catalog service with credits, Nevermined pays the merchant from its own treasury and your call costs a fixed number of credits that Nevermined publishes for that endpoint. You get credits in three ways:
  • Free credits when you sign up. A new account that signs up with a verified email gets 2,000 credits, with no card and no subscription. See Free credits.
  • Top-ups. Turn them on and a pack of 10,000 credits that never expire is charged to your card whenever your credits run out, up to a monthly limit you set — with or without a subscription. See Top-ups.
  • A Nevermined Subscription. You pay Nevermined a monthly price and get a monthly allowance of credits. See Subscribe.
All your credits are one balance, and they’re spent the same way whatever their source. That changes three things for an agent:
  • No wallet, no Delegation, no funding. There’s no wallet to fund and nothing on-chain for your agent to sign.
  • A price you see before you call. Each endpoint has a rate on Nevermined’s rate card — credits per call — and the rate shown when you call is what the call costs, whatever the merchant charges at that moment (up to the rate’s bound).
  • You only pay for what’s delivered. Credits are kept only when the merchant answers with a 2xx. Anything else and the credits come back.
Nevermined credits are not plan credits. Elsewhere in these docs, credits are what a seller’s credits-based plan grants for that seller’s own agent, and a subscription is a seller’s time-based plan. Nevermined credits and the Nevermined Subscription are neither: they’re Nevermined’s own, for buyers, and the credits are spent only through the Router, on catalog services. On this page, “credits” always means Nevermined credits.
Credits and a Delegation live side by side. Some services can’t be paid with credits (see What credits can pay); keep a Delegation for those.

Free credits

A new Nevermined account that signs up with a verified email gets 2,000 free credits, once, to try the catalog. You don’t need a subscription or a card to receive them or to spend them.
  • Who gets them. A new account that signs up with a verified email address: an email code, or a Google account. Accounts that existed before free credits launched don’t get them, and neither do wallet-only sign-ups or accounts created for you by an organization, an embedded widget or an SDK.
  • Once. They’re granted once per account and once per email address in each environment. Addresses that differ only in letter case, in a + suffix or, for Gmail, in dots count as the same address.
  • Nothing to claim. They’re added automatically when you first sign in — or at a later sign-in, while the offer lasts — and an email confirms how many you got and when they expire.
  • Live and Sandbox. Each environment grants its own credits. Sandbox credits pay the Sandbox test services, and Live credits pay live services.
  • They expire 30 days after they’re added. Unused free credits are lost when they expire. They aren’t refunded or replaced, and credits returned for an undelivered call aren’t restored if they’ve expired by then. A reminder email goes out 5 days before they expire, if you still have some.
  • One balance. If you also subscribe, your free credits and your monthly allowance are one balance, spent earliest expiry first. See Credits.
Free credits are a promotional offer, available while the offer lasts. Nevermined may remove unused free credits obtained or used in breach of its terms, for example by opening more than one account. To check whether the offer is open, and what it grants, read the public offer. It needs no API key:
offer is null while the offer is closed. See the API reference.

Spend your free credits

1

Sign up

Sign up in the Nevermined Catalog or the Nevermined App with an email code or Google. Your credits appear in the catalog’s account menu under Credits, and on the catalog’s Get started page as Your free credits. In the Nevermined App, Catalog Subscription in the Buy view shows them with their expiry and your recent usage.
2

Create a personal API key

Credits are spent with a personal API key: one with no organization. The catalog’s Get started page links to the API key generator with a personal agent key selected.
3

Connect your agent

Connect the Catalog MCP with that key. pay_service then pays in credits by default whenever they can pay the call. Or call the Router’s credits route directly. Its path says subscription, but it spends any Nevermined credits, with or without a subscription.
An assistant you connect through OAuth, such as the Catalog MCP from Claude.ai or ChatGPT, can spend your credits too, if you allow it. See Who can spend your credits.

Top-ups

Top-ups keep your agent going when your credits run out. Turn them on, and each time a call needs more credits than you can spend, Nevermined charges your card for a pack of 10,000 credits that never expire and the call goes ahead, up to a monthly limit you set. They’re for every personal account, with or without a subscription.
  • A pack is USD 10 plus applicable taxes for 10,000 credits. The tax is calculated from your billing address, and the total is shown before you pay.
  • Top-up credits never expire. They join your one balance. The credits that expire soonest are spent first, so top-up credits are spent last, after your free credits and your subscription’s allowance.
  • Off by default. You turn top-ups on by buying your first pack, and the card you pay it with pays the packs after it.
  • Only when a call needs it. While top-ups are on, a pack is charged automatically when a call costs more credits than you can spend, then the call is paid from your balance, which now includes the pack. A running call charges at most one pack, and only a call made with your personal API key charges one automatically — a call made through an OAuth connection never does.
  • An agent can also refill ahead of a call. Within the limit you set, an agent can charge a pack itself before it runs out — POST /api/v1/credits/topups/pack, or top_up_credits on the Catalog MCP — with no new approval. For an assistant connected through OAuth this is the only way to get a pack, and only if you ticked Let this assistant top up my Nevermined credits. Turning top-ups on and setting the monthly limit still happen only here, in the App.
  • Up to your monthly limit. You choose a monthly limit in whole US dollars, before tax; there’s no default. A pack is charged only while the packs bought this calendar month (UTC), that one included, stay within it. The lowest limit is the price of one pack, and the highest is USD 50, Nevermined’s maximum.
  • Not withdrawable. When you turn top-ups on, you ask for each pack’s credits to be made available immediately and give up the 14-day right of withdrawal, for your first pack and every pack charged automatically after it. See Refunds and disputes of a pack.
  • Live and Sandbox. Each environment has its own top-ups, packs and limit. A Sandbox pack is paid in test mode, and its credits pay the Sandbox test services.
These are Nevermined credits bought from Nevermined, spent only through the Router. They’re not the automatic credit top-ups of a seller’s plan, which a Delegation pays when a request settles.

Turn on top-ups

You turn top-ups on in the Nevermined App, on the same page as your credits.
1

Open the Top-ups panel

Open Catalog Subscription in the sidebar — it’s in the Buy view — or go straight to nevermined.app/subscription. The catalog’s Get started page links there too, with Set up top-ups. In the Top-ups panel, click Turn on top-ups.
2

Set your monthly limit

Type a monthly limit in US dollars, before tax. The panel says how many packs a month it allows: a USD 30 limit allows up to 3 packs a month.
3

Give the consents

Tick both boxes. The first agrees that Nevermined charges your card USD 10 plus applicable taxes for each pack of 10,000 credits that never expire: the first pack now, and another automatically each time your credits run out, up to your monthly limit. The second asks for each pack’s credits to be made available immediately and acknowledges that you lose your 14-day right of withdrawal once they are, for your first pack and every pack charged automatically after it. Top-up terms below the boxes has the full terms.
4

Pay for your first pack

Choose a saved card, or Add a card and enter its details. Confirm your billing country — with a postal code in the US and Canada — and the panel shows your total, such as Total today: $10.81, including $0.81 tax. Click Pay with •••• 4242. Your bank may ask you to confirm the payment (3-D Secure).
5

Your credits arrive

Once the payment is confirmed, top-ups are on, the pack’s 10,000 credits are in your balance, and an email sends you the receipt. The same card pays the packs charged automatically after this one.

Manage top-ups

The Top-ups panel shows what you bought this month against your limit, such as $10 of $30 this month, and the card that pays the packs. From there:
  • Change limit sets a new monthly limit. A limit below what you’ve already bought this month stops packs for the rest of the month.
  • Change card chooses another of your cards to pay the packs.
  • Turn off top-ups stops further packs. The credits you’ve bought stay in your balance. To turn top-ups on again, buy a pack again.
  • Packs lists your packs, newest first: when each was bought (At checkout or Automatic), its credits, price and tax, its status (Being charged, Paid, Declined, Not charged or Refunded), and a link to its receipt.
When this month’s packs reach your limit, the panel says so: no more packs are charged until the first day of next month (UTC), unless you raise the limit. While top-ups are on or paused, the catalog’s account menu also shows where they stand, such as Top-ups on, $10 of $30 this month. Nevermined emails you a receipt for every pack, a notice when this month’s packs reach 50%, 75%, 90% and 100% of your limit (only the highest, when one pack crosses several), a notice when an automatic pack can’t be charged and top-ups pause, and a confirmation when Nevermined support refunds a pack.

When top-ups pause

An automatic pack is charged while you’re away, so a card that can’t pay it pauses top-ups instead of retrying. While they’re paused, no pack is charged, and a call that needs more credits than you can spend is refused: a subscriber in good standing gets 402 BCK.SUBSCRIPTION_ROUTER.0009 with params.topUps: "paused", and anyone else gets 402 BCK.SUBSCRIPTION_ROUTER.0002. The panel says why: A declined pack charges nothing, and appears in Packs as Declined or Not charged. A card dispute stops top-ups too, but it isn’t a pause you can lift from the panel: every credit is frozen and calls are refused with 0015. A dispute on a pack shows in the panel as Top-ups are stopped and your credits are on hold; a dispute on your subscription doesn’t show there. See Refunds and disputes of a pack.

Refunds and disputes of a pack

Top-up packs can’t be withdrawn: when you turned top-ups on, you asked for each pack’s credits to be made available immediately and gave up the 14-day right of withdrawal, for every pack. Their credits stay in your balance and never expire. For a refund, contact Nevermined support. A refund through support removes the pack’s unused credits from your balance and returns their share of what you paid, tax included. The pack then reads Refunded in Packs, and it still counts toward that month’s limit. If you dispute a pack with your card issuer, its unused credits are removed, none of your credits — free, top-up or subscription — can be spent, and top-ups stop while the dispute is open. If it’s decided in Nevermined’s favour, the credits it removed are restored as top-up credits, and top-ups resume once no other dispute on a pack holds them. If it’s decided in your favour, your credits stay unable to spend.

Subscribe

You buy the subscription in the Nevermined Catalog, on the subscription page.
1

Open the subscription page

In the catalog, click Subscription in the header, or Subscribe for $20 a month on the catalog’s home page. Log in with your Nevermined account if the page asks you to.
2

Choose the subscription

The page compares the two ways to pay for the catalog: Pay per call from a budget you set up yourself, or the Nevermined Subscription. The subscription is USD 20 per month plus applicable taxes, and it grants 20,000 credits each month. Click Choose Subscription.
3

Give the consents

Tick both consents. The first agrees that the subscription renews automatically every month until you cancel. The second asks for your credits to be made available immediately, and acknowledges that you lose the 14-day right of withdrawal once they are. Then click Continue to payment.
4

Pay on the same page

Stripe’s secure payment form opens in the page. Accept the Nevermined Subscription terms in the form, then pay. VAT or sales tax is calculated from your billing address and added on top, and the total is shown before you pay; a business can add its tax ID. Your bank may ask you to confirm this first payment (3-D Secure).
5

Your credits arrive

After you pay, you land on your subscription page in the Nevermined App. Your credits appear there as soon as Stripe confirms the payment.

Personal accounts only

The Nevermined Subscription, top-ups and Nevermined credits belong to a personal account: an organization can’t subscribe or buy top-ups.
  • Spend credits with a personal API key — one with no organization tag — and without an X-Current-Org-Id header. A call made in an organization you’re an active member of (that header, or that organization’s API key) is refused with 402 BCK.SUBSCRIPTION_ROUTER.0002, and it never falls back to your personal credits.
  • Sandbox and Live are billed separately. Each workspace has its own subscription and its own credits, and the subscription page shows which workspace you’re subscribing for. A Sandbox subscription is paid in Stripe’s test mode, and its credits pay the testnet services listed in Sandbox — on the catalog’s services page, under Sandbox test services.

Manage your subscription

In the Nevermined App, open Catalog Subscription in the sidebar — it’s in the Buy view, so switch to it first if the App opens on Sell — or go straight to nevermined.app/subscription. (If you already subscribe, the catalog’s subscription page takes you there too.) The page shows:
  • Credits left this month, your plan and monthly allowance, and the date your allowance resets.
  • Credits, when you also hold free or top-up credits: how many you can spend now, and when each part of them expires.
  • Top-ups, where you turn them on and manage them. See Manage top-ups.
  • Manage billing, which opens Stripe’s customer portal, where you can update your payment method.
  • Cancel subscription, which opens Stripe’s cancellation step. A cancellation takes effect at the end of the current billing period, and you can use the rest of this month’s credits until then.
  • Invoices, with each invoice’s status. An invoice that was refunded reads Refunded or Partially refunded; if its refund state can’t be read, it reads Status unavailable. A refund can take 5–10 business days to appear on your card statement.
What your credits paid for is in Purchases. In the Nevermined App’s Purchases page, a call paid with credits shows Subscription under Paid with and its cost in credits (struck through when the credits came back). Filter by Subscription credits to see only those, and the Credits used · this cycle tile adds up the current billing period.

Credits

All the credits your account holds are one balance, whether they’re free credits, top-up credits or your subscription’s monthly allowance. A call costs its rate whatever the source, and the credits that expire soonest are spent first.
  • One allowance per billing period. Your plan includes a monthly allowance of 20,000 credits, available once each monthly invoice is paid. Changes to the price or the monthly allowance are announced in advance, and you can cancel before they apply.
  • The allowance expires at the end of the period. Unused allowance credits don’t roll over; your allowance resets when the next period’s invoice is paid. Free credits expire 30 days after they’re added, whatever your billing period.
  • Top-up credits never expire, so they’re spent last.
  • An overdue renewal freezes only the allowance. While a subscription payment is overdue, its allowance credits can’t be spent until the payment goes through. Your free and top-up credits still can, and top-ups stay on. But a call that the frozen allowance would have covered is refused (0016) instead of charging a pack: paying the overdue invoice is what unlocks it.
  • A card dispute freezes everything. While a card payment you made to Nevermined — for the subscription or for a top-up pack — is disputed with your card issuer, none of your credits can be spent, and top-ups stop.
  • They are not money. Credits have no cash value, can’t be cashed out, and can’t be transferred to another account.
Check your credits at any time, subscribed or not — it charges nothing:
  • spendable is what a personal API key can pay with right now — read it rather than adding up your calls. total also counts frozen credits.
  • parts lists what’s left by kind (welcome for free credits, allowance for a subscription’s monthly allowance, sla for credits Nevermined added for a defective result, topup for top-up credits), in the order they’re spent: earliest expiry first, never-expiring last. expiresAt is null on credits that never expire.
  • frozen is null on credits you can spend, renewal_overdue on an allowance frozen by an overdue renewal, and dispute on every part while a card dispute is open.
  • nextExpiry is the next credits to expire, or null when none of them expire.
  • topups holds your top-up settings, when top-ups are available to you. It’s left out when they’re not, or when they couldn’t be read this time.
In topups, amounts are US dollars before tax:
  • enabled is whether a pack is charged automatically when your credits run out. It’s false until you buy your first pack, and after you turn top-ups off.
  • monthlyLimitUsd is your monthly limit, or null if you never set one. It’s kept when you turn top-ups off.
  • maxMonthlyLimitUsd is the highest limit Nevermined allows.
  • boughtThisMonthUsd is what the packs bought this calendar month (UTC) cost — the figure your limit counts, refunded packs and a pack still being charged included.
  • packPriceUsd is the price of one pack, or null when no pack is on sale.
  • paused is null, or why no pack is being charged and since when: { "reason": "payment_failed", "since": "2026-10-19T10:00:00.000Z" }. reason is payment_failed (the last automatic pack was declined), action_required (its card asked for authentication), card_unavailable (the card that pays packs can no longer pay; API version 1.84 or later — older versions read payment_failed) or dispute (a card dispute on a top-up pack freezes every credit). A dispute on your subscription freezes every credit too, but leaves paused at null: read frozen on the parts. See When top-ups pause.
  • card is the card that pays packs (brand and last4), or null when none is saved.
You turn top-ups on and set the limit in the Nevermined App, not over the API: see Manage top-ups. An agent can read the limit (GET /api/v1/credits/topups/pack) and charge a pack within it (POST the same path, or top_up_credits) — see Top-ups. A caller with no credits gets "total": "0" and an empty parts. The balance is always your personal one: an organization tag on the key or an X-Current-Org-Id header is ignored. A call made in an organization never spends these credits, though (402 BCK.SUBSCRIPTION_ROUTER.0002). See the API reference. For your subscription itself — status, plan and reset date — read the subscription balance:
creditsLeft counts your whole balance, free credits included, frozen or not. spendable is about the subscription only: true while it’s active or trialing and not suspended by a card dispute on its payments, false otherwise. An overdue subscription (past_due or unpaid) freezes only its allowance, so your free and top-up credits can still pay a call then. And a dispute on another payment you made to Nevermined freezes every credit while this still reads true. Read spendable on GET /api/v1/credits/balance for what can pay right now. subscribed: false carries no other field. Called in an organization you’re a member of, it reads that organization’s subscription, never yours; organizations can no longer subscribe, so that’s normally subscribed: false.

In the catalog

Signed in, the catalog shows your credits in the account menu under Credits, subscribed or not, and where your top-ups stand. A subscriber also sees a status bar on the catalog’s home page, such as Subscribed · 19,835 credits left this month. When your credits can pay a call, the catalog shows service prices in credits instead of USD:
  • a service card priced like 15 credits, or from 15 credits when its endpoints differ;
  • on a service’s page, the credits one call costs and how many credits you have left, with each endpoint priced in credits — or marked Budget only when credits can’t pay it (Own crypto wallet only on a service that sells only to the payer’s own crypto wallet);
  • a switch on the services page, Pay with your budget instead, that turns the prices back into USD.
Everyone else sees USD prices; quote a call (below) for its price in credits.

The rate card: what a call costs

Every endpoint that credits can pay has a rate: the number of credits one call costs. The rate shown when you make the call is what that call costs — the merchant’s price at that moment doesn’t change it. (The API calls a rate’s version tariffVersion.)
  • In the MCP, get_service called with your API key shows subscription.creditsPerCall (and the tariffVersion) on each endpoint that credits can pay.
  • Over REST, quote the exact call. Nothing is reserved or charged, and the merchant isn’t contacted:
A quote refuses what the call would refuse before contacting the merchant (see When a call is refused). It never checks the merchant’s live price or Nevermined’s treasury, and for a subscriber in good standing it doesn’t check how many credits are left — those are checked when the call is made. Without a subscription in good standing, it refuses a call your spendable credits can’t cover (0002, or 0016 when only a frozen allowance would), unless an automatic top-up would cover it.

How a rate is set

Nevermined prices each endpoint from the merchant’s own price. It takes what the merchant charges for a call, applies a markup, converts the result to credits at a nominal value per credit, and rounds up to the next step of a fixed scale of credit amounts — so every rate is a whole number of credits on that scale. Nevermined re-prices endpoints regularly as merchant prices move; between two pricings, the stored rate is what every call costs. Each rate also bounds what Nevermined will pay the merchant. If the merchant’s live price rises above that bound, the call is refused before anything is paid (BCK.SUBSCRIPTION_ROUTER.0004), and the endpoint is flagged for re-pricing. A subscription call carries no Router fee: the rate is the whole cost. The rate card is live. It covers every catalog endpoint that credits can pay, and those services’ own prices move all the time, so rates — and the markup, credit value and scale behind them — change, up or down, as soon as Nevermined updates them, without notice. Quote before you call when the cost matters; the rate in force at the time of the call is what you pay.

Pay a call with credits

Call a catalog service by its slug, exactly as you would through POST /api/v1/router/route, but on the subscription route and without a Delegation. Despite its name, the route spends any of your credits, with or without a subscription:
What’s different from the Delegation route:
  • A slug, never a URL. Credits pay listed catalog services only, so the request names a slug (plus path, method, search, headers, body). A url or a delegationId is refused (400 BCK.SUBSCRIPTION_ROUTER.0005), not ignored, so a request that meant something else is never paid with credits.
  • requestId is required, as on every mode-B call: a retry with the same id is never paid twice — see Paying twice.
  • Nothing to sign or fund. Nevermined pays the merchant and never hands you a payment credential — there is no subscription equivalent of minting a credential.
  • No routing fee. A subscription call costs its rate and nothing else.
  • Long calls behave as on the Delegation route: past the synchronous wait you get 202 with a resultUrl to poll, and the credits stay Reserved until the call ends.
  • A top-up shows on the call that charged it. When this call ran out of credits and, with top-ups on, charged a pack to cover itself, the response — the result, or the 202 — also carries topUp: the credits the pack added and its price before tax. Your card was charged, so tell the person you’re acting for.
For large or streamed responses, the streaming form is ALL /api/v1/router/subscription/svc/{slug}/{path}. Point your HTTP client at it with your API key and an X-Router-Request-Id header; the method, body and headers pass through and the response streams back with X-Router-Credits-Charged and X-Router-Credits-Status alongside the usual X-Router-Payment-* headers, plus X-Router-Topup-Credits and X-Router-Topup-Amount-Usd when the call charged a top-up pack. X-Router-Target-Url, X-Router-Target-Slug and X-Router-Delegation-Id are refused on this route.

When a service doesn’t deliver

Your credits are reserved before the merchant is called and kept only if it answers with a 2xx. An error status, a timeout, a dropped connection, or a merchant that refuses the payment all mark the call’s credits for refund, and they come back automatically, with the expiry they had. If that expiry has passed by then, allowance credits come back with this period’s expiry (once the subscription has ended, they’re lost), and free credits are lost. A 502 with BCK.ROUTER.0034 (no response from the service) or BCK.ROUTER.0025 (its reply was too large to deliver) can come after the merchant was paid. The credits are refunded all the same, but don’t retry with a new requestId — read the outcome with the same one from the payment ledger. On the streaming route, a 2xx counts as delivered when its headers arrive: a body that breaks off mid-stream keeps its credits Committed. Contact support if that happens. payment.creditsStatus says where a call’s credits stand: A failed call’s response body is null: you see the merchant’s status, never its error body. If a service answered successfully but its result was defective, the credits are not returned automatically — contact support, and Nevermined may add credits to your current monthly allowance at its discretion (credits added this way expire at the end of the current billing period). Nevermined doesn’t promise the availability or uptime of third-party services. Read the final state of any call from the payment ledger. In the rare case where the Router can’t tell whether a call was delivered, the call is reviewed and either confirmed or refunded — its credits stay Reserved until then.
Credits never move on a refused call. Every refusal below happens before the merchant is paid and before any credit is reserved, so there is nothing to refund.

What credits can pay

Credits pay listed, live catalog endpoints that carry a rate, on these rails:
  • x402 merchants using the exact scheme, paid in USDC,
  • MPP merchants on the tempo method, paid in the USD stablecoin Nevermined’s treasury holds there — per call (charge) or over a session, where the treasury opens and closes the channel,
  • MPP merchants on the evm method, a USDC charge on Base paid like x402, per call.
Credits don’t pay MPP card (stripe / Shared Payment Token) merchants, a raw URL that isn’t in the catalog, an endpoint without a fixed price, or an endpoint whose result only the paying wallet can read back — a job you poll, or something you’d own at the merchant. Nevermined also doesn’t sell some services for credits at all, on any endpoint — Dune (dune-mpp) is one — and refuses them with params.reason: credits_excluded. On a service that delivers results only to the wallet that paid, credits pay just the endpoints Nevermined has reviewed as self-contained (the paid response is the whole result); the rest are refused with params.reason: wallet_bound. Pay all of these from a Delegation — a wallet_bound endpoint only from your own crypto (erc4337) Delegation, since a card or organization Delegation is refused there too.

Who can spend your credits

  • A personal Nevermined API key: one with no organization tag, used without an X-Current-Org-Id header. This is how an agent you run yourself spends them, through the Catalog MCP or the API.
  • An assistant you connected through OAuth (for example the Catalog MCP from Claude.ai or ChatGPT), only if you ticked Let this assistant spend my Nevermined credits on the consent screen. It’s off by default. With it on, the assistant can read and spend your personal credits at eligible catalog services, with no separate credit cap, until you revoke the connection. A call it makes never charges a top-up pack on its own; to let it charge one within your limit, also tick Let this assistant top up my Nevermined credits — then it can call top_up_credits. It can’t start a subscription for you, turn on top-ups, or spend an organization’s credits. Without it, pay_service pays from the connection’s stablecoin spending cap instead, and a call to the credits route is refused with 403 BCK.OAUTH.0037. An existing connection never gains this permission on its own: reconnect to allow it.
Any other kind of OAuth credential is refused with 403 BCK.OAUTH.0030. An OAuth connection can’t read GET /api/v1/credits/balance either, even one allowed to spend your credits: that balance takes a personal API key.

No spending limits beyond your credits

Credits have no spending limit beyond your balance — no daily, per-service or pace cap. The Router’s usual per-service rate limit and concurrency limit still apply (429). A call can also be refused when Nevermined’s treasury can’t pay right now — most often because its float is low (503 BCK.SUBSCRIPTION_TREASURY.0003, retryable). Nothing is charged; retry later.

When a call is refused

Branch on code. None of these spent or reserved any credit, and none charged anything — except that with top-ups on, a 0009 can follow a top-up pack charged to your card (params.topUps: bought, or pending), and so can a 0015 or 0016 (params.topUps: bought), as the table below says.

When no top-up covers the call

With top-ups on, a call that runs out of credits charges a pack and goes ahead. When it can’t, it’s refused with 402 BCK.SUBSCRIPTION_ROUTER.0009, and params.topUps says why. Without a subscription in good standing, though, a call made while top-ups are paused, at the limit or still charging a pack never gets that far: it’s refused 0002, with no params.topUps. No credits were spent on the refused call in any case, but with bought, and possibly pending, your card was charged for a pack. A 0009 without params.topUps usually tried no pack: top-ups are off, or not available to you. (It can also come after another call’s pack covered this one and was spent before this call could use it.) A call that a frozen allowance would have covered (0016) or that a card dispute froze (0015) never charges a pack. One refused that way after it charged a pack (a dispute opened, or a renewal went overdue, in between) says so: params.topUps: "bought", with the pack’s params.purchaseId — tell the person you’re acting for that their card was charged. Other errors with a 5xx status (BCK.SUBSCRIPTION_ROUTER.0006 and 0010–0014, and the remaining BCK.SUBSCRIPTION_TREASURY.* codes) are on Nevermined’s side and also charge nothing; retryable says whether retrying can help. The Router’s common errors apply too — a reused requestId (409 BCK.ROUTER.0002), the rate and concurrency limits (429): see every error code. A service paid over an MPP session (a payment channel) can also answer 409 BCK.ROUTER.0042 or 503 BCK.ROUTER.0043. Nevermined pays it over one channel shared by everyone paying with credits, so while that channel is busy, or closing — when its deposit reaches its ceiling, or when the service refuses the channel or a top-up of it; the next call after the close opens a new one — calls to that service are refused for everyone. Closing usually takes about a minute, and 15 minutes or more when the service does not accept a cooperative close. Nothing is charged; retry later with the same requestId. The full list is in the error reference. BCK.SUBSCRIPTION_TREASURY.0004–0007 and 0014 are retired: they belonged to spending limits removed before launch, and the API no longer returns them.

In the ledger

Calls paid with credits land on the same payment ledger as everything else, with three extra fields. fundingSource is subscription on every credits call, free credits included: delegationId is null on a credits call, and feeBps is 0: there is no routing fee. To read one call’s final state, look it up by the requestId you sent:
presence: "absent" means no payment is recorded for that requestId yet — while the call may still be running, retry it with the same requestId, never a new one. See Look up one payment by requestId.

From the Catalog MCP

With credits and a personal API key — or an OAuth connection allowed to spend them — the Catalog MCP’s pay_service pays, and quote_service prices, in credits by default when your credits and the endpoint qualify. With a personal API key, get_budget and wallet_balance report your credits. When a call that goes ahead charges a top-up pack, pay_service says so in topUpMessage, for your assistant to tell you.

Refunds and disputes of the subscription itself

These are about the monthly fee, not a single call. Subscription fees are non-refundable, except where the law requires a refund or for billing errors.
  • If a subscription payment is refunded in full, the unused credits it granted are removed. A refund can take 5–10 business days to appear on your card statement.
  • If you dispute a payment with your card issuer, its unused credits are removed and none of your credits — free and top-up credits included — can be spent while the dispute is open, so no top-up pack is charged either. If the dispute is decided in your favour, they stay unable to spend. If it’s decided in Nevermined’s favour, those credits are restored with their original expiry — credits whose billing period has ended by then come back already expired.

How the Router works

Mode A and mode B, and the Delegation-funded path.

Guardrails

Every check on a Delegation-funded payment.

Payment ledger

Query and export every payment, credits included.

Catalog MCP

Discover and pay from an AI assistant.
Identity disclosure is unsupported on subscription route calls. Any revealBuyerIdentity field (including false or null) or X-Router-Reveal-Buyer-Identity header is refused with BCK.SUBSCRIPTION_ROUTER.0005 rather than silently ignored. Omit them on subscription routes.