# Invo Network API Documentation

> Invo Network is a unified ledger and payments infrastructure used by game developers and non-gaming platform partners. Server-to-server REST API authenticated by a single X-Game-Secret-Key header. Designed for portfolios with millions of players.

## Documentation Site

- Website: https://docs.invo.network
- Production API: https://invo.network/api
- Sandbox API: https://sandbox.invo.network/sandbox/api
- Developer Console: https://console.invo.network
- Sandbox Console: https://dev.console.invo.network

## Docs

- [Introduction](https://docs.invo.network/docs/introduction): Learn how to get started with Invo Network API for cross-game currency transfers. Complete introduction guide for game developers.
- [Quick Start](https://docs.invo.network/docs/quick-start): Get started with Invo Network in 5 minutes. Step-by-step guide to integrate cross-game currency transfers.
- [API Overview](https://docs.invo.network/docs/api-overview): Complete overview of Invo Network API endpoints, authentication, and core concepts for cross-game currency integration.
- [Authentication](https://docs.invo.network/docs/authentication): Learn how to authenticate with Invo Network API using API keys and secure your game integration.
- [Partner Credentials & Key Handling](https://docs.invo.network/docs/partner-credentials): The three credentials every Invo integration needs (game_id, SDK secret_key, webhook signing secret), where each lives, the server-side player-token rule, webhook verification, and key rotation.
- [Sandbox Testing](https://docs.invo.network/docs/sandbox-testing): Test your integration in the isolated sandbox environment at sandbox.invo.network. Test cards, no real money.
- [Game Developer Integration](https://docs.invo.network/docs/game-developer-integration): End-to-end integration guide: signed checkout sessions, iframe/WebView, webhook events, Unity/Unreal/iOS/Android examples.
- [Unity SDK](https://docs.invo.network/docs/unity-sdk): Complete documentation for the InvoSDK Unity plugin. Learn how to integrate in-game currency purchases, item marketplace, player-to-player transfers, and cross-game currency sends in your Unity game.
- [Unreal Engine SDK](https://docs.invo.network/docs/unreal-sdk): Complete documentation for the InvoSDK Unreal Engine plugin. Learn how to integrate in-game currency, item purchases, and player transfers in your Unreal Engine game.
- [Web / TypeScript SDK](https://docs.invo.network/docs/web-sdk): Official Invo Web SDK for web games, storefronts, and dashboards. Install @invonetwork/web-sdk to add currency purchase, item purchase, and passkey-verified sends/transfers to any web or Node app.
- [Python SDK](https://docs.invo.network/docs/python-sdk): Official Invo Python server SDK. Install invonetwork to add currency purchase, item purchase, sends/transfers, balances, and webhook verification to any Python backend (Django, Flask, FastAPI).
- [Game Registration](https://docs.invo.network/docs/game-registration): Step-by-step guide to register your game with Invo Network and get API credentials for cross-game currency integration.
- [Player Management](https://docs.invo.network/docs/player-management): Manage players in your game using Invo Network API. Create, update, and track player accounts across games.
- [Virtual Currency Setup](https://docs.invo.network/docs/virtual-currency): Configure virtual currency in your game for cross-game transfers using Invo Network API.
- [Cross-Game Transfers](https://docs.invo.network/docs/cross-game-transfers): Enable cross-game transfers in your game to allow players to move value between different games.
- [Player Balance API](https://docs.invo.network/docs/balance-overview): Learn how to check and manage player currency balances using Invo Network Balance API.
- [Get Player Balance](https://docs.invo.network/docs/get-balance): API documentation for retrieving player balance information using Invo Network API.
- [Currency Purchase API](https://docs.invo.network/docs/currency-purchase): Implement currency purchase functionality in your game using Invo Network Purchase API.
- [Steam Payments](https://docs.invo.network/docs/steam-purchase): Accept real-money currency top-ups through Steam in-game purchasing with the Invo Network Steam payment rail.
- [Item Purchase API](https://docs.invo.network/docs/item-purchase): Enable item purchases in your game using Invo Network Item Purchase API for seamless transactions.
- [Platform Commerce API](https://docs.invo.network/docs/platform-commerce): Sell items on your platform through Invo with dual funding: a user's Invo-network balance or a direct card payment. Server-side funding resolution, refunds, and webhooks.
- [Payment Methods](https://docs.invo.network/docs/payment-methods): Learn about supported payment methods for currency and item purchases in Invo Network.
- [Transfer Overview](https://docs.invo.network/docs/transfer-overview): Overview of cross-game transfer functionality and how players can move value between games.
- [Available Destinations](https://docs.invo.network/docs/available-destinations): API documentation for retrieving available destination games for player transfers.
- [Player-Aware Destinations](https://docs.invo.network/docs/player-destinations): API documentation for /api/players/destinations — returns the games where a specific player already has a presence, intersected with the source tenant's transfer policy. The recommended endpoint for transfer / send UIs.
- [Write-Response Contract](https://docs.invo.network/docs/write-response-contract): Documentation for the canonical top-level new_balance field returned by every Invo write endpoint that affects a player balance — purchase, transfer, send, item-purchase. Type, units, when null, recommended dual-read pattern with GET /player-balances.
- [Initiate Transfer](https://docs.invo.network/docs/initiate-transfer): Learn how to initiate cross-game transfers for players using Invo Network Transfer API.
- [Verify Transfer](https://docs.invo.network/docs/verify-transfer): Verify cross-game transfers using SMS PIN verification for secure player transactions.
- [Claim Transfer](https://docs.invo.network/docs/claim-transfer): Complete cross-game transfers by claiming transferred value in the destination game.
- [Player-to-Player Sends](https://docs.invo.network/docs/send-overview): Enable player-to-player currency sending and gifting functionality in your game.
- [Send Destinations](https://docs.invo.network/docs/send-available-destinations): API documentation for finding available players to send currency to across games.
- [Initiate Player Send](https://docs.invo.network/docs/initiate-send): Initiate player-to-player currency sends using Invo Network Send API.
- [Verify Send SMS](https://docs.invo.network/docs/verify-send-sms): Verify player-to-player sends using SMS verification for secure currency gifting.
- [Claim Sent Currency](https://docs.invo.network/docs/claim-currency): API documentation for claiming currency sent by other players across games.
- [In-App Verification](https://docs.invo.network/docs/in-app-verification): Verify cross-game transfers and player-to-player sends in-app with a hardware-backed device signature. Faster, SIM-swap resistant, and reduces SMS costs. Additive and opt-in per game; SMS stays as the fallback.
- [Device Enrollment](https://docs.invo.network/docs/device-enrollment): Mint a short-lived player token server-side and register a device with its hardware-backed public key. The signing contract (device_signal) and key rotation for in-app verification.
- [Approve in App](https://docs.invo.network/docs/app-approve): Poll the pending list and approve a transfer or send with a hardware device signature instead of an SMS PIN, including biometric step-up handling.
- [Confirm Receipt](https://docs.invo.network/docs/app-confirm-receipt): The receiver confirms an incoming player-to-player send in-app with a device signature; the funds are credited and the send completes. Claim-code remains the fallback.
- [Platform Step-Up (WebAuthn / Passkeys)](https://docs.invo.network/docs/platform-step-up): Add WebAuthn / passkey step-up to web platforms: phishing-resistant, hardware-bound, user-verified approval for high-value transfers and sends, hosted on your own origin. An additive alternative to the mobile device signature.
- [Guardian Approval (Minor Accounts)](https://docs.invo.network/docs/guardian-approval): Standard integration pattern for handling pending_guardian_approval (HTTP 202) on transfer and currency-send calls. Polling endpoint, state machine, suggested partner UI, and sandbox testing instructions.
- [Wallet Identity Lookup](https://docs.invo.network/docs/wallet-identity-lookup): GET /api/wallet/identities — fetch every email attached to a player’s Invo wallet so your UI can pre-populate the list. Game-secret authenticated, scoped to your game’s players only.
- [Webhooks](https://docs.invo.network/docs/webhooks): Receive signed, real-time webhook events from Invo (purchase.completed, transfer.received, item.purchased, refunds). HMAC-SHA256 signature verification, idempotency-key de-duplication, retry/backoff, dead-letter and secret rotation.
- [Webhook Management API](https://docs.invo.network/docs/webhook-management): Manage webhook subscriptions server-to-server with your X-Game-Secret-Key: create/update, rotate the signing secret, fire test events, view delivery history and metrics, replay dead-letters, and tune timeouts/retries/rate-limit/gzip.
- [Platform Partners](https://docs.invo.network/docs/partners): Non-gaming platform partner integration: branded currency, hosted checkout, cross-tenant transfers, and programmatic payouts.

## Optional

- [Full Documentation](https://docs.invo.network/llms-full.txt): Complete plain-text documentation for AI consumption.