> ## Documentation Index > Fetch the complete documentation index at: https://docs.darwin.so/llms.txt > Use this file to discover all available pages before exploring further. # Top Up > Add funds to an Agent Wallet or configure automatic funding. Top ups are owner-controlled money actions. OAuth applications and service accounts cannot retrieve a saved payment method or silently fund a user's Agent Wallet. ## Manual top up 1. Read the agent's current billing projection. 2. Start payment-method setup if the owner has no eligible saved method. 3. Create a wallet top up for a USD amount using an idempotency key. 4. Wait for the authoritative wallet or webhook state before retrying blocked work. Do not increase a displayed balance optimistically. Payment confirmation and wallet crediting can complete asynchronously. ## Auto top-up The owner can configure automatic funding with a saved payment method, threshold, amount, and limits. A recurring agreement can reference the approved behavior, but it cannot broaden the owner's global funding permissions. When auto top-up fails, Darwin leaves the affected execution or recurring occurrence paused and returns `funding_required`. Notify the owner without exposing payment-provider details. Understand available, reserved, promotional, pending, and withdrawable balances.