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-ai/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

# Add a new credit card
hoody wallet payment-methods create \
  --name "Personal Visa" \
  --details '{"token": "tok_1LgR....Dc2"}' \
  --is-default

SDK

const paymentMethod = await client.api.wallet.addPaymentMethod({
  name: 'Personal Visa',
  type: 'credit_card',
  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 from a saved card:

CLI

# Process a $100 payment
hoody wallet payments create \
  --amount "100.00" \
  --reason "Monthly infrastructure top-up"

SDK

const payment = await client.api.wallet.processPayment({
  payment_method_id: PAYMENT_METHOD_ID,
  amount: '100.00',
  reason: 'Monthly infrastructure top-up',
});
// payment.data.transaction — the transaction record
// payment.data.invoice — auto-generated invoice
// payment.data.balance — updated balance

HTTP

curl -X POST "https://api.hoody.icu/api/v1/wallet/payments/" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "payment_method_id": "507f1f77bcf86cd799439130",
    "amount": "100.00",
    "reason": "Monthly infrastructure top-up"
  }'

Funds available immediately. No additional fees. Invoice 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
hoody wallet invoices download $INVOICE_ID

# 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_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 payments status $PAYMENT_ID

SDK

const status = await client.api.wallet.getPaymentStatus(PAYMENT_ID);

HTTP

curl -X GET "https://api.hoody.icu/api/v1/wallet/payments/$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.