{
"paymentId": "b1f9c2e4-3d5a-4c7e-9f21-6a8b0c4d2e13",
"protocol": "x402",
"credential": {
"transport": "header",
"name": "PAYMENT-SIGNATURE",
"value": "eyJ4NDAyVmVyc2lvbiI6MiwiYWNjZXB0ZWQiOnsuLi59LCJwYXlsb2FkIjp7Li4ufX0="
},
"settlement": {
"recipient": "0x209693Bc6afc0C5328bA36FaF03C514EF312287C",
"amount": "1000",
"network": "base-sepolia",
"approxCents": "1",
"asset": "USDC",
"scheme": "exact"
},
"fee": {
"bps": 0,
"amount": "0",
"cents": "0",
"capChargedCents": "1",
"capChargedMicros": "2040"
},
"delegationId": "5e7481c3-...",
"status": "Issued",
"x402Version": 2,
"resourceUrl": "<string>",
"requestId": "<string>"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}Mint Payment Credential
Pay any x402-compatible agent WITHOUT that agent integrating Nevermined. Returns a signed credential you attach to your own request to the agent.
Prerequisite: a spending Delegation. Create one once via POST /api/v1/delegation/create
with provider: 'erc4337', a spendingLimitCents, and a durationSecs; pass its id as
delegationId here (an organization-wallet delegation, or a stripe card delegation for
MPP-stripe, works too; see delegationId). The Router signs with your custodial wallet and
enforces the cap. Fund
that wallet first: an x402 payment and an MPP evm charge are not balance-checked, so an
underfunded wallet still gets its credential, the routing fee for issuing it can still be
collected, and the payment then fails when the merchant settles it.
Steps:
- Call the agent once WITHOUT payment → it replies HTTP 402 with requirements. x402 v1 puts
them in the JSON body
{ x402Version: 1, accepts: [...] }; x402 v2 puts them in a base64PAYMENT-REQUIREDresponse header (decode to an object). Pass what you got astarget. - POST here. The Router selects a fundable option, signs an x402
exact(EIP-3009) payment, reserves the amount against your Delegation, and returnscredential+settlement. - Re-send your original request to the agent with the HTTP header named
credential.name(PAYMENT-SIGNATUREfor v2,X-PAYMENTfor v1) set tocredential.value. The agent verifies, settles on-chain, and returns the resource.
Optionally call POST /api/v1/router/payments/{id}/settled, with the returned paymentId
as {id}, with the on-chain tx to complete the audit record.
Pass a stable requestId, and reuse it across every retry of the same purchase. The
Router hands out at most one credential per id: once a payment is recorded under the id, a
retry returns 409 BCK.ROUTER.0002, whose params carries the original paymentId, instead
of minting again. A refused call records nothing, so the id stays free and the next attempt
with it mints again. That includes a 500: after a 500 BCK.ROUTER.0010 a credential may
already have been minted and withheld, and a retry fails the same way, so report it rather
than retrying. Without an id, or with a fresh id per HTTP attempt, a retry is a new purchase, so it
mints a second credential AND is charged the routing fee a second time. Derive the id from the
work you are doing, not from a UUID generated per attempt. An id is unique per account, across
every Router route and every delegation, and never expires: two different purchases that
derive the same id collide, and the second is refused.
This route never issues a credential twice. If the first response was lost (a timeout, a
dropped connection), the retry gets the 409 and that credential cannot be fetched again. The
merchant is not paid with it unless it is presented, but any routing fee charged for issuing
it stays charged, and its price stays reserved against your delegation cap until the Router
releases it: on x402 and the MPP tempo and evm charges, once its authorization window has
passed and the chain shows it unused. Look the payment up with GET /api/v1/router/payments?requestId=…
(your id, URL-encoded). To buy again, make a new purchase on purpose, with a new requestId
and a new charge, on this route or through mode B, where the Router presents the credential
itself, so a lost response cannot strand it. On a tight cap that purchase can get
402 BCK.ROUTER.0003 until the reserve is released.
The id is checked first: only request-level refusals come before it, namely the API-key and
request-context checks (401, 403 BCK.OAUTH.0030), an invalid Nevermined-Version (400), the
rate limit (429), the body validation (400) and the subscription-funding refusal
(400 BCK.SUBSCRIPTION_ROUTER.0007). A retry of a paid id therefore gets the 409 with its
paymentId, never a later refusal that would read as “nothing was paid”.
Prefer POST /api/v1/router/route to have the Router call the agent and pay in one step (mode B).
MPP: set protocol: "mpp" and pass the raw WWW-Authenticate: Payment … header value as
target.challenge to pay a Machine Payments Protocol merchant. With a crypto delegation that
is a method="tempo" charge (a native Tempo transaction) or a method="evm" charge (an
EIP-3009 authorization on Base or Base Sepolia, recorded with scheme exact). With a card
(stripe) delegation it is a method="stripe" challenge, where the deployment enables that
rail (see protocol). The Router
returns an Authorization: Payment <…> credential (attach it under header credential.name).
A wallet that signs through an EIP-7702 smart account cannot pay an evm charge (the merchant
accepts only a plain ECDSA signature), so that call is refused with 400 BCK.ROUTER.0001
before the payment is signed, reserved or charged; if the service also offers x402, pay that
offer (protocol: "x402"). See target for which wallets that covers.
{
"paymentId": "b1f9c2e4-3d5a-4c7e-9f21-6a8b0c4d2e13",
"protocol": "x402",
"credential": {
"transport": "header",
"name": "PAYMENT-SIGNATURE",
"value": "eyJ4NDAyVmVyc2lvbiI6MiwiYWNjZXB0ZWQiOnsuLi59LCJwYXlsb2FkIjp7Li4ufX0="
},
"settlement": {
"recipient": "0x209693Bc6afc0C5328bA36FaF03C514EF312287C",
"amount": "1000",
"network": "base-sepolia",
"approxCents": "1",
"asset": "USDC",
"scheme": "exact"
},
"fee": {
"bps": 0,
"amount": "0",
"cents": "0",
"capChargedCents": "1",
"capChargedMicros": "2040"
},
"delegationId": "5e7481c3-...",
"status": "Issued",
"x402Version": 2,
"resourceUrl": "<string>",
"requestId": "<string>"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}{
"code": "BCK.ROUTER.0003",
"httpStatus": 500,
"message": "delegation budget exceeded, expired, or inactive",
"details": "Hash JWT is not signed by the node account",
"error": "authorization_pending",
"hint": "Verify the wallet has sufficient balance and that the plan is active.",
"docsUrl": "https://nevermined.ai/docs/development-guide/api-errors/codes#bck-x402-0008",
"category": "integration",
"retryable": true,
"correlationId": "a3f6b1c4-7d2e-4a9b-8e0c-12f4d8e6c5b9",
"uuid": "e-550e8400-e29b-41d4-a716-446655440000",
"date": "2026-05-09T12:34:56.789Z",
"params": "{\"planId\":\"43298432984329\",\"reason\":\"Invalid configuration\"}"
}Authorizations
Your Nevermined API Key (starts with 'nvm:'). Get one at nevermined.app under Settings > API Keys.
Body
Delegation id (a capped spend authority) to spend against — created via POST /api/v1/delegation/create. It must be the caller’s own erc4337 delegation, a delegation funded by an organization wallet that funds a group the caller is an active member of (while the wallet, the group and the organization’s plan allow that spend), or the caller’s own card (stripe) delegation, which pays only mpp (see protocol).
Payment protocol. x402 (EIP-3009 exact) or mpp (Machine Payments Protocol). With a crypto delegation, mpp pays a method="tempo" charge, or a method="evm" charge, which is recorded with scheme exact. A card (stripe) delegation pays only mpp, and only a method="stripe" challenge (MPP-stripe: the Router issues a Stripe Shared Payment Token). Any other card payment, and every card payment on a deployment that does not enable that rail, is refused with 400 BCK.ROUTER.0001. The target shape depends on this: x402 → { accepts, x402Version? }; mpp → { challenge }.
x402, mpp "x402"
The upstream's payment requirements, taken verbatim from its HTTP 402 response — its shape depends on protocol.
• x402 — pass { accepts: [...], x402Version? }: accepts is the array of payment options the agent advertised (each with scheme, network, asset, payTo, maxAmountRequired/amount, and extra.name/extra.version for the EIP-712 domain). Get it from the 402 body (x402 v1: { x402Version: 1, accepts }) or by base64-decoding the PAYMENT-REQUIRED response header (x402 v2). x402Version defaults to 2 when omitted — set it to 1 for x402-express agents. Pass extra through verbatim: the Router signs under the EIP-712 domain it holds for the settlement token, and checks the advertised extra.name/extra.version against it byte for byte — an agent that publishes a domain its own token does not sign under is rejected with BCK.ROUTER.0012 (nothing is signed, charged or reserved).
• mpp — pass { challenge }, where challenge is the raw WWW-Authenticate: Payment … header value from the merchant’s 402, verbatim — e.g. Payment id="…", method="tempo", intent="charge", request="<base64url>". The Router decodes it, verifies the buyer wallet can fund the tempo charge, signs a native Tempo transaction, and returns an Authorization: Payment <…> credential (the ledger scheme is charge). The tempo payment currency (token address) must be on the operator’s per-chain allowlist. A challenge offering method="evm" (and no tempo offer) is paid as an EIP-3009 authorization in USDC/EURC on Base or Base Sepolia, under the same funded-network and token rules as x402 (the ledger scheme is exact). An evm merchant accepts only a plain ECDSA signature that recovers to the paying address, so a wallet that signs through an EIP-7702 smart account cannot pay it. This route first makes your own wallet an EIP-7702 account wherever EIP-7702 is enabled, so on such a deployment a personal delegation (one that spends from your own wallet) cannot pay an evm charge here. A delegation that spends from an organization wallet is refused the same way once that wallet’s walletMode is eip7702. Such a call is refused with 400 BCK.ROUTER.0001, whose details names the reason, before the payment is signed, reserved or charged. Mode A pays only the target you pass and never switches to another offer: if the service also offers x402, pay that offer instead (protocol: "x402" with its accepts), or call POST /api/v1/router/route, which pays such a 402 on its x402 offer itself unless requireProtocol pins it to mpp.
{ "x402Version": 1, "accepts": [ { "scheme": "exact", "network": "base-sepolia", "maxAmountRequired": "1000", "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e", "payTo": "0x209693Bc6afc0C5328bA36FaF03C514EF312287C", "maxTimeoutSeconds": 60, "extra": { "name": "USDC", "version": "2" } } ] }
Per-call ceiling, in whole cents, on the fee-inclusive price: the merchant’s price plus any collectable Router fee. The price is compared with it at micro resolution (1/10,000 of a cent), so a call is refused only when its price is above maxTotalCents cents, never because rounding to whole cents pushed it over. A call above it is refused with 402 BCK.ROUTER.0018 before anything is signed and before a payment record or delegation reserve is written.
0 <= x <= 90071992547409915
Caller correlation / idempotency id, recorded verbatim and looked up byte for byte. The Router hands out at most one credential per id: once a payment is recorded under the id, a retry gets 409 BCK.ROUTER.0002 instead. A refused call records nothing, so the id stays free and the next attempt with it mints again; after a 500 BCK.ROUTER.0010 that attempt fails the same way, so report it rather than retrying. An id is unique per account, across every Router route and every delegation, and never expires: two different purchases that derive the same id collide, and the second is refused. An empty string is the same as omitting it (no id).
256Response
A signed credential + settlement descriptor + record id. Attach credential.value under header credential.name to your request to the agent.
Was this page helpful?