# VoIPStore Account Top-Up

> VoIPStore Account Top-Up is a paid API for AI agents from api.voipstore.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Adds USDC credit to a VoIPStore account balance for purchasing temporary non-VoIP virtual phone numbers for SMS verification

## Facts

- Endpoint: POST https://api.voipstore.xyz/agent/v1/topup?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/voipstore-account-top-up-2a23fc3f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yyWrqrUI1koH3lPVlntGI

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability voipstore-account-top-up-2a23fc3f -d '<json body>'
```

Example prompt: Top up my VoIPStore account with $20 USDC so I have enough credit to buy virtual numbers for SMS verification.

## When to prefer this

Use this endpoint when an agent needs to fund a VoIPStore account with USDC to enable subsequent purchases of temporary non-VoIP virtual phone numbers. This is a prerequisite step before renting virtual numbers for SMS verification workflows. Prefer this over manual top-up when automating pipelines that consume virtual numbers at scale.

## Known failure modes

- Amount outside allowed range ($5.00–$100.00) returns a validation error
- Insufficient USDC balance for x402 payment fails the transaction before crediting
- Invalid or malformed amount_usd parameter returns a 400 error
- Network or payment facilitator timeout leaves status as pending indefinitely
- Duplicate rapid requests may result in duplicate charges

## How this service works

Receive SMS verification codes instantly with temporary non-VoIP virtual numbers in 150+ countries. Verify WhatsApp, Telegram, Google, Discord and 1,300+ apps

## Output

Returns a JSON object with a recharge status ('pending'), a unique recharge_id integer for tracking the transaction, and the credited amount converted to EUR (e.g. credited_eur: 4.54).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "amount_usd": {
   "type": "number",
   "description": "USDC amount (5.0-100.0), passed in the query string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "pending",
  "recharge_id": 1,
  "credited_eur": 4.54
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/voipstore-account-top-up-2a23fc3f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.voipstore.xyz](https://www.zero.xyz/host/api.voipstore.xyz/llms.txt)