Wallet Management
8 min
before you begin create or select a team, then work in a staging environment before configuring production resources api keys, webhooks, wallets, and payment activity belong to the selected environment if voltage has already configured an environment and wallet for your team, continue to developer guide docid\ l4sp3ernfdbslxqajxoeg key concepts environment separates staging and production workflows use different credentials and webhook registrations for each environment wallet holds balances and payment activity for one environment an environment can contain multiple wallets development wallet uses a test network or test balance with no real world value choose the wallet according to the implementation being tested mutinynet bitcoin bitcoin backed implementations, including node backed bitcoin and credit backed bitcoin mutinynet usd usd line of credit implementations that move payments over bitcoin or lightning while using a usd denomination voltage cash experimental stablecoin testing only it is not currently live for production use because the intended tether backed asset has not yet been minted production wallet uses the production network and approved funding model for live payments api key an environment scoped secret sent in the x api key header grant only the permissions required by the application or service create an environment from the team overview, select new environment enter a descriptive name, such as staging select create , then open the environment when it is ready new environment form filled with the name staging use a clearly named environment for isolated staging work newly created staging environment in the voltage dashboard open the environment after creation to manage its wallets and credentials use a separate production environment when the integration is ready for live activity create a wallet open the intended environment and select add new wallet enter a wallet name and select continue choose development or production select the wallet currency and backing model required by your implementation select create and wait for the wallet overview to load provisioning is asynchronous do not assume a fixed completion time; wait for the current product status before using the wallet development wallet choices showing mutinynet bitcoin selected with mutinynet usd and voltage cash unselected choose mutinynet bitcoin for bitcoin backed tests, mutinynet usd for usd line of credit tests, or voltage cash only for experimental stablecoin testing staging environment with two ready development wallets wait for the wallet to become available before depending on it use the wallet dashboard the wallet overview shows the network, balance or amount owed, credit usage when applicable, payment actions, and activity select receive to create a payment request select send to enter a destination and review a payment before submission use all payments and payment requests to review status and history use filters to narrow payment activity by time, id, status, type, or direction use reports to generate payment history or wallet balance snapshot reports for a selected date range wallet settings page for a development wallet open wallet settings when you need to verify the selected wallet's configuration and identifier empty wallet reports page reports are generated from the selected wallet's reports page generate report form with report type and date range fields choose a supported report type and date range before generating the report create an api key open the selected environment's api keys page and select create api key give the key a descriptive name enable only the permissions the integration needs add an ip allowlist when the caller uses stable source addresses create the key and store the one time secret in an approved secret manager never place an api key in source control, screenshots, logs, tickets, or chat empty api keys page for the selected environment api keys are created and managed within the selected environment create api key form with permissions and an example ip allowlist grant only required permissions and add an ip allowlist when source addresses are stable find identifiers organization id use the organization identifier supplied for your payments api integration environment id use the identifier for the selected staging or production environment wallet id open wallet settings or list wallets through the payments api line of credit id retrieve current line of credit resources through the payments api when the operation requires one avoid relying on a fixed dashboard location for an identifier product navigation can change, while api responses remain the source of truth for programmatic workflows next steps developer guide docid\ l4sp3ernfdbslxqajxoegstaging environment docid\ ukhb7 3ektubbv hblw1tsending docid\ ijeswowxjhpgyt6fv1kk1receiving docid uq9knquoc9sgq0kuogmywebhooks docid\ pdeh 4et9aqawca5q91napayments access docid\ txpojpm5pxe1ksxjbt2an