{"uid":"cap_xaJ5LpOFTgiuBTbdcv2zN","slug":"agentline-billing-top-up-x402-usdc-payment-444aca7c","name":"AgentLine Billing Top-Up (x402 USDC Payment)","description":"Get a real phone number for your AI agent in under 10 minutes. Works with OpenClaw, Hermes Agent, and any LLM. Outbound calls, SMS, and inbound voice — one API. No telecom experience needed.","url":"https://api.agentline.cloud/v1/billing/topup/x402/pay","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"amount":{"type":"string","description":"Optional top-up amount (USD) to advertise requirements for. Must be $5.00–$1000.00; omit for the minimum."}}},"responseSchema":{},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"5","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":"$5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_llyZxVgSWFGLM9CgSV_Zi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Tops up an AgentLine account balance using a USDC micropayment via the x402 protocol, funding outbound calls, SMS, and inbound voice capabilities for AI agents.","exampleAgentPrompt":"Top up my AgentLine account with $20 in USDC so I have enough credits to keep making outbound calls.","exampleUseCases":[{"title":"Fund AI agent calling budget","prompt":"Add $50 to my AgentLine account using USDC so my AI agent has enough balance to handle outbound sales calls this week."},{"title":"Refill SMS and voice credits","prompt":"My AgentLine voice credits are running low — can you top up the account with $25 so the agent can keep sending SMS and taking inbound calls?"},{"title":"Minimum top-up before first call","prompt":"I just set up my AI phone agent on AgentLine and need to fund it — add the minimum $5 to get started with outbound calls."}],"resultDescription":"On success, the endpoint confirms the USDC payment has been processed and the corresponding USD credit has been applied to the AgentLine account, enabling usage of phone numbers, outbound calls, SMS, and inbound voice features. The response body schema is currently empty, so the confirmation may be implicit in a 200/201 HTTP status code.","failureModes":["Insufficient USDC balance in the paying wallet — payment rejected","Amount below $5.00 minimum — request rejected with validation error","Amount above $1000.00 maximum — request rejected with validation error","Invalid or malformed x402 payment header — authentication failure","Network or blockchain confirmation timeout — payment may be unconfirmed","Account not found or unauthorized — 401/403 error"],"whenToPreferThis":"Use this endpoint when an AI agent needs to autonomously fund its own AgentLine telephony account using USDC via the x402 payment protocol — particularly when operating in a crypto-native or agentic payment pipeline. Prefer this over manual billing portals when the agent needs to self-serve credits programmatically without human intervention.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:28.054Z","isFirstParty":false}