---
name: stabledomains-payments
description: StableDomains: Payments: USDC/USDT, x402, balance. Part of https://stabledomains.net/skills.md.
---

# Payments: USDC/USDT, x402, balance

MCP: https://stabledomains.net/api/mcp · OpenAPI: https://stabledomains.net/api/openapi.json · Index: https://stabledomains.net/skills.md

Chains: base, ethereum, arbitrum, polygon, hyperevm (USDT0), bsc (18 decimals), solana. Tokens: USDC, USDT. 1 USDC/USDT = 1 USD.
- **Direct transfer:** the 402 from `POST /api/v1/orders` gives an exact amount (unique sub-cent suffix), `pay_to` and token contract. Send exactly that, then `POST https://stabledomains.net/api/v1/orders/{id}/pay` with `X-PAYMENT-TX: <hash>`, or just poll (auto-detected). MCP `pay_order`.
- **x402 (gasless, USDC on Base):** retry the same request with an `X-PAYMENT` header signed per the 402 body. Also used for paid data endpoints.
- **Prepaid balance:** `POST https://stabledomains.net/api/v1/balance/topup`, then orders with `"pay_with":"balance"` (MCP `buy_with_balance`).
Always send `Idempotency-Key` on POST /orders.
