{"uid":"cap_geRd2fHQ1-l2bvWaHiqcF","slug":"reachpad-router-credit-top-up-64267b29","name":"Reachpad Router Credit Top-Up","description":"Virtual machines for agents: disposable Linux VMs, sandboxes and dev servers — ask for cpu, RAM, disk and region, get the cheapest eligible cloud provider, run commands over SSH or exec, pay per second in credits funded by USDC (x402) or card.","url":"https://router.reachpad.dev/v1/credits/topups","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"amount":{"type":"string","pattern":"^\\d+(\\.\\d{1,6})?$","description":"The top-up amount before fees, at least the minimum top-up. Decimal USD as a string, e.g. \"0.15\"."},"method":{"enum":["usdc","card"],"type":"string","description":"\"usdc\" answers 402 with the x402 payment block for the amount; retry the same request with the payment. \"card\" needs an API key and returns a checkout URL."},"issue_key":{"type":"boolean","description":"Ask this payment to return the account's API key. Needs a payment on the request, freshly signed (its validity must end within 10 minutes), and spends one of the wallet's ten re-issues per five minutes. Rotates the key of an account that already exists (the old key stops working) and returns the new one; on the payment that creates the account the key comes back anyway. Last rotation wins, so never send two flagged payments in parallel."}}},"responseSchema":{"type":"json","example":{"api_key":"rp_key_… (only when this payment created the account)","balance":"23.75","deposit":{"fee":"1.25","paid":"25.00","method":"usdc","credited":"23.75","processor":"x402","created_at":"2026-09-02T00:00:00.000Z","machine_id":null,"external_ref":"x402:0xabc…:0x…"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__wBJLZSzQi8hkyteWe0Iw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Adds credits to a Reachpad account to fund disposable Linux VM usage, paid via USDC (x402) or card.","exampleAgentPrompt":"Add $25 of credits to my Reachpad account using USDC so I can spin up more Linux VMs for my agent workflows.","exampleUseCases":[{"title":"Bootstrap new agent compute account","prompt":"I just signed up for Reachpad — deposit $10 to my account via USDC to get started running disposable Linux VMs."},{"title":"Refill low compute budget before job","prompt":"My Reachpad balance is running low — top it up with $50 using USDC before I kick off the next batch of sandboxed agent tasks."},{"title":"Top up by card for team use","prompt":"Add $100 of Reachpad credits via card so our team has enough compute budget for the dev server experiments this week."}],"resultDescription":"Returns the updated account balance, a detailed deposit record (amount paid, fee deducted, net credits added, payment method, processor, timestamp), and — if this payment created the account — the new API key. For card payments, returns a checkout URL instead of an x402 payment block.","failureModes":["Amount below minimum top-up threshold — request rejected with validation error","Invalid amount format (not a decimal string matching pattern) — 400 bad request","x402 payment not yet confirmed on-chain — 402 response prompting retry with payment header","Card method used without a valid API key — authentication error","Network or processor timeout during payment confirmation — transient 5xx error","Duplicate payment submission — may return idempotency or conflict error"],"whenToPreferThis":"Use this endpoint when an AI agent or automation needs to pre-fund a Reachpad account before provisioning disposable Linux VMs, sandboxes, or dev servers. Prefer the USDC/x402 method for fully automated, agent-driven top-ups without human checkout flow; use card method when a human-initiated checkout is acceptable. Choose this over generic payment APIs because it is purpose-built for Reachpad's per-second VM billing credit system.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:30:51.243Z","isFirstParty":false}