Billing & Payments

Two balances. Transparent pricing. No surprises.

Your money goes into a General Balance for infrastructure or an AI Balance for LLM credits. You pick the payment method — credit card (instant), crypto (private), or bank transfer (bulk). Every transaction is logged. Every invoice is generated automatically. Everything is accessible via HTTP.

---

Check Your Balance

Before spending, know what you have:

CLI

# See both balances at once
hoody wallet balance get

# General balance only
hoody wallet balance general

# AI balance only
hoody wallet balance ai

SDK

import { HoodyClient } from 'hoody-sdk';
const client = new HoodyClient({ baseURL: 'https://api.hoody.icu', token: process.env.HOODY_TOKEN });

// All balances — general + AI
const balances = await client.api.wallet.getAggregateBalances();
console.log(balances.data);
// { general_balance: "125.50", ai_limit: "50.00", ai_usage: "23.45", ai_remaining: "26.55" }

// General balance only
const general = await client.api.wallet.getGeneralBalance();

// AI balance only
const ai = await client.api.wallet.getAiBalance();

HTTP

# Aggregate balances
curl -X GET "https://api.hoody.icu/api/v1/wallet/balances" \
  -H "Authorization: Bearer $TOKEN"

# General balance
curl -X GET "https://api.hoody.icu/api/v1/wallet/balances/general" \
  -H "Authorization: Bearer $TOKEN"

# AI balance
curl -X GET "https://api.hoody.icu/api/v1/wallet/balances/ai" \
  -H "Authorization: Bearer $TOKEN"

---

Three Payment Methods

Credit Cards

Providers: Visa, MasterCard, American Express Processor: Stripe (PCI-compliant) Fees: None Speed: Instant

Save a card once. Pay from it whenever you want. Hoody never sees your card number — Stripe handles everything.

Cryptocurrencies

Supported: BTC, ETH, USDT, USDC, LTC, 100+ more Processor: NOWPayments Fees: +5% processing Speed: 5-60 minutes (blockchain confirmation)

No account needed. No identity required. Just send to the address and wait for confirmation.

Bank Transfer

Minimum: $500+ Fees: None from Hoody (your bank may charge) Speed: 1-3 business days

Contact support for account details. Best for large deposits and enterprise accounts.

---

Add a Payment Method

Save a credit card for repeat payments:

CLI

# Adding a payment method is not possible from the CLI -- see the SDK/HTTP tabs.
# The CLI can only inspect and manage methods that already exist:
hoody wallet payment-methods list

Caution

hoody wallet payment-methods create cannot create a method as shipped. The API requires a top-level type, the CLI exposes no --type flag, and a type placed inside --details is ignored because the server reads it top-level — so every invocation returns 400 “Invalid payment method type”. Use the SDK or HTTP flow below.

SDK

const paymentMethod = await client.api.wallet.addPaymentMethod({
  type: 'credit_card',
  name: 'Personal Visa',
  details: { token: 'tok_1LgR....Dc2' },  // Stripe.js one-time token
  is_default: true,
});
console.log(paymentMethod.data.id); // "507f1f77bcf86cd799439131"

HTTP

curl -X POST "https://api.hoody.icu/api/v1/wallet/payment-methods/" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Personal Visa",
    "type": "credit_card",
    "details": { "token": "tok_1LgR....Dc2" },
    "is_default": true
  }'

Note

The token is a one-time Stripe token generated by frontend JavaScript. Hoody never handles raw card details. All card data is stored by Stripe (PCI DSS Level 1).

Manage Saved Cards

CLI

# List all payment methods
hoody wallet payment-methods list

# Set a card as default
hoody wallet payment-methods set-default $PAYMENT_METHOD_ID

# Delete a card
hoody wallet payment-methods delete $PAYMENT_METHOD_ID

SDK

// List all
const methods = await client.api.wallet.listPaymentMethods();

// Set default
await client.api.wallet.setDefaultPaymentMethod(PAYMENT_METHOD_ID);

// Delete
await client.api.wallet.deletePaymentMethod(PAYMENT_METHOD_ID);

HTTP

# List all
curl -X GET "https://api.hoody.icu/api/v1/wallet/payment-methods/" \
  -H "Authorization: Bearer $TOKEN"

# Set default
curl -X PUT "https://api.hoody.icu/api/v1/wallet/payment-methods/$PAYMENT_METHOD_ID/default" \
  -H "Authorization: Bearer $TOKEN"

# Delete
curl -X DELETE "https://api.hoody.icu/api/v1/wallet/payment-methods/$PAYMENT_METHOD_ID" \
  -H "Authorization: Bearer $TOKEN"

---

Make a Payment

Add funds to your General Balance with a card via Stripe Checkout:

CLI

# Card top-ups complete on Stripe's hosted checkout page, so they run
# through the SDK/HTTP API or the dashboard — not a direct CLI charge.
# From the CLI, check your balance and transactions:
hoody wallet balance get
hoody wallet transactions list

Caution

There is no CLI command that charges a card directly. hoody wallet payments create targets a legacy mock gateway that is disabled in production — use the SDK or HTTP Stripe Checkout flow below (or the dashboard) to add funds.

SDK

// Card top-up via Stripe Checkout. Redirect the user to the returned
// checkout URL; the wallet is credited after Stripe confirms settlement
// (webhook), not instantly.
const checkout = await client.api.wallet.createStripeCheckout({
  amount: '100.00',
  idempotency_key: 'topup-2026-06-10-001',
});
// checkout.data.intent.redirect_url — hosted Stripe Checkout URL to open
// checkout.data.intent.id — payment intent id (poll with getStripePaymentIntent)

HTTP

curl -X POST "https://api.hoody.icu/api/v1/wallet/payments/stripe/checkout" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "100.00",
    "idempotency_key": "topup-2026-06-10-001"
  }'

Redirect the user to the returned checkout URL. Funds are credited after Stripe confirms settlement (usually within seconds). No additional fees; an invoice is generated automatically.

---

Cryptocurrency Payments

Private. Borderless. No account required.

How It Works

1. Initiate Payment

   Select cryptocurrency in the dashboard or API. The amount is converted to crypto at the current exchange rate.

2. Send to Address

   You receive a unique payment address. Send the exact amount shown (including the 5% fee).

3. Wait for Confirmation

   • Bitcoin: 15-60 minutes (1-6 confirmations)
   • Ethereum: 5-15 minutes (12 confirmations)
   • Litecoin: 10-30 minutes (6 confirmations)
   • Stablecoins (USDT/USDC): 5-15 minutes (varies by chain)

4. Funds Added

   Confirmation email sent. Invoice generated. Balance updated.

Caution

+5% processing fee on all crypto payments. This covers volatility risk during blockchain confirmation, network fees, and exchange costs. Example: deposit $100 worth of crypto, you pay $105 equivalent, and your General Balance receives $100.

Supported Currencies

BTC, ETH, USDT, USDC, LTC — and 100+ more via NOWPayments. Check the payment interface for the complete list.

---

Bank Transfer

For large deposits and enterprise accounts.

1. Contact Support

   Email with your desired amount, account ID, and preferred currency (USD, EUR).

2. Receive Bank Details

   Account number, routing details, SWIFT/BIC code, and a reference number (required for crediting).

3. Send Transfer

   Include the reference number in the transfer notes. Without it, crediting may be delayed.

4. Funds Arrive (1-3 business days)

   Balance updated. Email confirmation. Invoice generated.

Caution

Always include the reference number in your bank transfer. Without it, we have to manually match the transfer to your account — that means delays.

No Hoody fees on bank transfers. Your bank may charge wire/SWIFT/conversion fees.

---

Transaction History

Every payment, charge, transfer, and refund — all in one place:

CLI

# List recent transactions
hoody wallet transactions list

# Get details for a specific transaction
hoody wallet transactions get $TRANSACTION_ID

SDK

// List transactions
const txns = await client.api.wallet.listTransactions({ limit: 50, sort_by: 'created_at', sort_order: 'desc' });

// Get a specific transaction
const txn = await client.api.wallet.getTransaction(TRANSACTION_ID);

HTTP

# List transactions
curl -X GET "https://api.hoody.icu/api/v1/wallet/transactions?limit=50&sort_by=created_at&sort_order=desc" \
  -H "Authorization: Bearer $TOKEN"

# Get specific transaction
curl -X GET "https://api.hoody.icu/api/v1/wallet/transactions/$TRANSACTION_ID" \
  -H "Authorization: Bearer $TOKEN"

Each transaction includes: unique ID, amount, currency, type (payment, credit, debit, refund, adjustment), status (pending, completed, failed, cancelled), timestamp, and related invoice.

---

Invoices

Every payment generates an invoice automatically. Download them for accounting, taxes, or client billing:

CLI

# List all invoices
hoody wallet invoices list

# Download invoice as PDF (-o raw is required -- the default output
# JSON-stringifies the binary body and is not a usable PDF)
hoody wallet invoices download $INVOICE_ID -o raw > invoice.pdf

# Generate invoice for a transaction that's missing one
hoody wallet invoices generate $TRANSACTION_ID

SDK

// List invoices
const invoices = await client.api.wallet.listInvoices({ limit: 10, sort_by: 'created_at', sort_order: 'desc' });

// Download PDF
const pdf = await client.api.wallet.downloadInvoicePdf(INVOICE_ID);

// Generate missing invoice
await client.api.wallet.generateInvoice(TRANSACTION_ID);

HTTP

# List invoices
curl -X GET "https://api.hoody.icu/api/v1/wallet/invoices/?limit=10&sort_order=desc" \
  -H "Authorization: Bearer $TOKEN"

# Download PDF
curl -X GET "https://api.hoody.icu/api/v1/wallet/invoices/$INVOICE_ID/pdf" \
  -H "Authorization: Bearer $TOKEN" -o invoice.pdf

# Generate missing invoice
curl -X POST "https://api.hoody.icu/api/v1/wallet/invoices/generate/$TRANSACTION_ID" \
  -H "Authorization: Bearer $TOKEN"

---

Payment Method Comparison

Method	Speed	Fees	Best For
Credit Card	Instant	None	Regular top-ups, automation
Cryptocurrency	5-60 min	+5%	Privacy, international, no-account
Bank Transfer	1-3 days	Bank fees vary	Large deposits ($500+), enterprise

Choose based on what matters to you: speed (card), privacy (crypto), or volume (bank transfer).

---

Troubleshooting

Credit Card Declined

Your bank may flag hosting purchases as suspicious. Call your bank to whitelist Stripe. Verify the card hasn’t expired and the billing address matches. Check payment status:

CLI

hoody wallet transactions list --limit 10  # no CLI command for payment-intent status — use the SDK/HTTP tab

SDK

// For a card payment, look up its Stripe intent (crypto: getCryptoPaymentIntent)
const status = await client.api.wallet.getStripePaymentIntent(PAYMENT_ID);

HTTP

# Card payment (crypto: /wallet/payments/crypto/intents/$PAYMENT_ID)
curl -X GET "https://api.hoody.icu/api/v1/wallet/payments/stripe/intents/$PAYMENT_ID" \
  -H "Authorization: Bearer $TOKEN"

Crypto Payment Not Credited

Check the blockchain explorer for your transaction hash. Bitcoin needs 1-6 confirmations, Ethereum needs 12. If confirmed but not credited, contact support with the transaction hash and payment reference.

Bank Transfer Missing After 3+ Days

Verify you included the reference number. Check with your bank that the transfer was processed and not held for review. SWIFT transfers can take up to 5 days. Contact support with your bank confirmation and transfer details.

---

What’s Next

Wallet & Balance Management Dual-balance system — transfer between General and AI balances

Wallet & Payments API Full endpoint reference — every parameter, every response schema

Rent Servers Browse the marketplace and provision bare metal infrastructure

---

Pay how you want. Card, crypto, or wire. Every transaction logged. Every invoice generated. Everything over HTTP. This is billing that gets out of your way.