> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neosantara.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Frequently Asked Questions

> Answers to common questions regarding balance top-ups, payment methods, billing currency, and gateway operations.

This page provides answers to commonly asked questions about billing, Rupiah deposit balances, API integration, and Neosantara gateway policies.

## Payments & Balance Top-Up

> [accordion] What is the minimum balance top-up amount?
>
> The minimum deposit top-up is **IDR 50,000** per invoice transaction. Once paid, the funds are credited directly to your account balance for use across all available models on the gateway.

> [accordion] Which payment methods are supported?
>
> Neosantara integrates with Mayar to support instant Indonesian payment channels:
>
> * **QRIS**: Compatible with all banking apps and digital e-wallets including GoPay, OVO, DANA, ShopeePay, LinkAja, BCA Mobile, and Livin' Mandiri.
> * **Virtual Account (VA)**: BCA, Bank Mandiri, BNI, BRI, and Permata Bank.
>
> Invoices are generated directly from the [Billing Dashboard](https://app.neosantara.xyz/billing).

> [accordion] Is billing processed in USD or Indonesian Rupiah (IDR)?
>
> All balances, transactions, and deductions are processed **100% natively in Indonesian Rupiah (IDR)**.
>
> No international credit cards or foreign exchange conversions are required on your end. Model pricing is displayed in Rupiah, and internal ledger records use `NUMERIC(20,6)` database types to eliminate floating-point rounding errors.

> [accordion] How long does it take for funds to reflect in the account?
>
> Funds are credited **instantly**. As soon as your payment is confirmed by your bank or e-wallet provider via Mayar webhooks, your API balance updates automatically and becomes immediately available for inference requests.

> [accordion] How are payment transaction fees handled?
>
> Invoices are securely processed through Mayar. Any applicable service fees or payment rail surcharges are itemized transparently on the invoice checkout page before finalizing payment.

## Balance Model & PAYG Billing

> [accordion] How does the Pay-As-You-Go billing model work?
>
> Neosantara operates on a pure Pay-As-You-Go system. Your balance is automatically deducted based on the actual tokens (input and output) generated on each successful API request. There are no hidden fees, and failed requests never charge your balance.

> [accordion] Do deposit balances expire?
>
> **Deposit balances never expire**. Your Pay-As-You-Go credits remain in your account permanently and can be used at any time.

> [accordion] Are there monthly subscription fees or minimum maintenance fees?
>
> There are no mandatory monthly recurring fees for API gateway access. Neosantara operates on a pure Pay-As-You-Go model where you only pay for the tokens and requests you consume.

> [accordion] What happens if balance runs out during an inference request?
>
> If your account balance is insufficient to process an API request, the gateway returns HTTP `402 Payment Required`. You can top up your balance at any time via the dashboard to resume API requests immediately.

> [accordion] If the gateway routes through an internal fallback provider, which rate applies?
>
> You are **always billed based on the requested model rate**. If a primary provider experiences downtime and the gateway routes to a fallback provider, the cost charged to your account never increases.

## Token Usage & Endpoints

> [accordion] How do I inspect balance and usage history?
>
> You can track your active balance, per-model token consumption, and latency logs directly from the [Usage Dashboard](https://app.neosantara.xyz/usage) and [Billing Dashboard](https://app.neosantara.xyz/billing). The dashboard provides real-time visual analytics.

> [accordion] Are hidden reasoning tokens or failed tool calls billed?
>
> Only successfully delivered public output is billed. Public reasoning tokens generated by reasoning models are billed at output token rates. Requests that fail due to upstream provider errors or dropped connections are not charged.

> [accordion] How do I raise my rate limits (RPM and TPM)?
>
> Usage tiers upgrade automatically based on your cumulative deposit history. Moving to higher tiers raises Requests Per Minute (RPM) and tokens per minute (ITPM and OTPM) limits automatically without manual requests.

## Data Security & Compliance

> [accordion] How does Neosantara handle Indonesian Personal Data Protection (UU PDP)?
>
> Neosantara offers automated PII redaction tailored for Indonesian data identifiers. You can redact national identity numbers (NIK), phone numbers, credit card data, and sensitive strings prior to upstream transmission by adding this header:
>
> ```http HTTP icon="terminal" theme={"theme":{"light":"catppuccin-latte","dark":"ayu-dark"}}
> X-Guard: on
> ```

> [accordion] Does Neosantara store prompts for model training?
>
> Neosantara itself **does not store** your prompt text or conversation data for model training on our servers. The gateway only records operational metadata (token counts, model IDs, latency, and response status codes) for billing calculations and dashboard analytics.
>
> At the provider level, data handling policies depend on the respective upstream model provider (such as OpenAI, Anthropic, or Google). Certain upstream providers may enforce their own retention or training policies depending on the model and tier. To ensure sensitive information is never transmitted to upstream providers, enable automated data redaction by passing the `X-Guard: on` header on your requests.

## Related Resources

| Need | Guide |
| :- | :- |
| Monitor usage & top up balance | [Billing Dashboard](https://app.neosantara.xyz/billing) |
| Requests and tokens per minute limits | [Rate Limits & Throughput](https://docs.neosantara.xyz/en/guides/rate-limits.md) |
| Automated PII data redaction | [Data Guardrails & PDP Law](https://docs.neosantara.xyz/en/guides/guardrails.md) |
| Model token pricing | [Model Catalog](https://docs.neosantara.xyz/en/gateway/models.md) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.