{"title":"How to Pay for invinoveritas (v1.6.2)","description":"Pay via the Lightning Network (Bearer Token recommended, or L402 invoices) — or with x402 stablecoin (USDC on Base), live on /reason. x402 is additive: agents funded on a USDC/corporate-budget mandate can pay without holding Lightning sats.","supported_payments":{"bearer":{"name":"Bearer Token (Recommended)","description":"Pre-funded credit account. Best for autonomous agents, trading bots, and long-term use.","flow":"POST /register → get api_key","usage":"Authorization: Bearer ivv_...","advantages":["Simple long-term usage","a free api_key on signup","Fine-grained per-call billing","No wallet needed after initial setup"]},"l402":{"name":"L402 Lightning (Pay-per-call)","description":"Classic atomic Lightning micropayments. No account needed.","flow":"Receive 402 → pay Bolt11 invoice → retry with Authorization: L402 <payment_hash>:<preimage>","wallets":["Alby","Zeus","Mutiny","Phoenix","Breez"],"advantages":["Fully decentralized","True micro-payments"]},"x402":{"name":"x402 Stablecoin (USDC on Base)","description":"Pay-per-call in USDC via the x402 protocol — for agents funded on a stablecoin/corporate-budget mandate. Additive to Lightning; live on /reason. Settled through the CDP facilitator (we never custody the transfer).","flow":"Send 'X-Payment-Scheme: x402' → receive a 402 with x402Version + accepts[] → sign the EIP-3009 authorization → retry with the X-PAYMENT header → served + X-PAYMENT-RESPONSE","network":"Base mainnet (USDC)","advantages":["No Lightning wallet needed","Funds from a USDC budget mandate","Standard x402 protocol (coinbase/x402 SDK compatible)"]}},"wallet_requirement":{"required":true,"details":"A Lightning wallet is required only for top-ups, L402 payments, and withdrawals. Once your Bearer account is funded, normal API usage requires no wallet — just your api_key."},"important_note":"For smooth autonomous operation we strongly recommend using **Bearer Token** after registration.","steps":[{"step":1,"title":"Register your account","action":"POST /register for a free API key","result":"Receive API key"},{"step":2,"title":"Make requests","bearer":"Use Authorization: Bearer <api_key>","l402":"Pay per call with L402 header when needed"}],"for_trading_bots":{"recommended":"Bearer Token (pre-funded)","tips":["Pre-fund your Bearer account for uninterrupted high-frequency calls","Combine with 'want_confidence' for better risk-aware decisions","Use persistent memory (/memory/store) for long-term agent state"]},"resources":{"register":"/register","topup":"/topup","balance":"/balance","guide":"/guide","prices":"/prices","mcp":"/mcp","memory":"/memory","sdk":"https://pypi.org/project/invinoveritas/","agent_wallet_guide":"https://github.com/babyblueviper1/invinoveritas/blob/main/docs/agent-wallet-guide.md","llm_integration_prompt":"https://github.com/babyblueviper1/invinoveritas/blob/main/docs/llm-integration-prompt.md","chatgpt":"https://chatgpt.com/g/g-69ed266a38648191a72f77613a3057ec-invinoveritas"},"next_steps":["1. Register free: POST /register","2. Use your Bearer token for all calls","3. Top up anytime via /topup (Lightning)","4. Monitor usage at /balance","5. Try persistent memory at /memory/store","6. Give your agent a wallet: see agent_wallet_guide link above"],"new_in_1_1_0":"Persistent agent memory service for long-term context and state"}