---
title: "Recharge prepaid agent phone service"
method: POST
path: "/v1/billing/topup/x402/pay"
tags: ["Agent Recharge"]
---

# Recharge prepaid agent phone service

`POST /v1/billing/topup/x402/pay`

## Request

- Base URL: `https://api.agentline.cloud`
- URL: `https://api.agentline.cloud/v1/billing/topup/x402/pay`
- Auth: none required

Recharge $1–$1000 with Base x402 or Tempo MPP; get prepaid credit and agent access without login.

## Query parameters

- `amount` number, nullable

## Request body

- PayDiscoveryBody
  - `amount` number, nullable: Recharge USD amount, $1–$1000; defaults to $1.

## Response `200`

Prepaid recharge credited and agent access issued.

- object
  - `status` 'settled', required
  - `amount_usd` number, required
  - `new_balance` number, required
  - `tx_hash` string
  - `agent_token` string: Save as Bearer access for wallet agents.
  - `owner_wallet` string
  - `access_mode` 'wallet_agent' | 'signup_account', required
  - `payment_protocol` 'x402' | 'mpp', required
  - `network` string, required
  - `already_settled` boolean

## Other responses

- `402`: Retry this URL with exactly one payment credential.
- `409`: Payment outcome uncertain or in progress; retry the same credential, never pay again.
- `422`: Validation Error

---

[API](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents.md) · [All operations](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/revisions/18c0bdbb4b30?raw)