---
updatedAt: 2026-09-07T13:35:45.000Z
agentTools:
  projectIndex: https://developer.1money.com/llms.txt
---

# Digital Wallets

Digital Wallets allow each 1Money customer to hold, send, and receive digital assets (e.g., stablecoins) within 1Money on-platform wallet, while all underlying assets are securely custodied and managed through 1Money’s regulated infrastructure. Each wallet is uniquely linked to a customer portfolio, enabling precise attribution, real-time balance updates, and programmable asset movement.

Unlike external self-custody wallets, 1Money Digital Wallets abstract away private key management and blockchain complexity, while still providing on-chain settlement and transparency where applicable.

Once your account is approved, call [Get Deposit Instructions](https://developer.1money.com/reference/get_deposit_instructions) to retrieve the wallet address for a specific asset and network.

<Callout icon="📘" theme="info">
  Do not cache deposit instructions. Always retrieve deposit instructions from the API immediately before displaying them to your users or initiating a transfer. Bank account details, wallet addresses, reference codes, and other deposit information may change. Using stale deposit instructions can result in misrouted funds or failed transactions.
</Callout>

<br />

### Key Features

* **Dedicated Wallet per Portfolio**: Each customer portfolio is assigned one or more unique digital wallets, scoped by asset and network.
* **Multi-Asset and Network Support**: Hold and transact supported stablecoins and digital assets (e.g., USDC, USDT) across approved networks.
* **Automated Attribution**: Incoming on-chain transfers are automatically attributed to the correct portfolio and asset balance.
* **Programmable Transfers**: Funds can be moved via API for payouts, conversions, treasury operations, or internal transfers.
* **Gas & Network Abstraction**: 1Money manages network fees and transaction execution, optionally enabling gasless experiences for end users.
* **Compliance-Ready**: Wallets are issued under 1Money’s regulated entities and linked to verified KYC/KYB profiles with full transaction monitoring.

<br />

### Common Use Cases

* Receive stablecoin payments from external wallets or counterparties.
* Support merchant settlement, remittances, payroll, or treasury operations in digital assets.
* Power embedded wallets for platforms operating under a platform, agency, or B2B2C model.

<br />

### Example Flow

1. To create an additional deposit address, the platform calls `POST /v1/customers/{customer_id}/deposit_instruction` with a `network` and optional `nickname` in the JSON body, plus a required `Idempotency-Key` header containing a valid UUID. The request has no `asset` field. See [Create Crypto Deposit Address](https://developer.1money.com/reference/create_crypto_deposit_address).
2. The response includes a `deposit_instruction_id` and a status. If the status is `PENDING`, retrieve the address using [Get Crypto Deposit Address](https://developer.1money.com/reference/get_crypto_deposit_address) until it is `READY` before displaying or using it. Use only assets supported on the selected network.
3. External sender transfers digital assets to the wallet address.
4. 1Money detects the on-chain transaction and credits the portfolio balance.
5. Platform receives a Wallet Deposit webhook confirming settlement.
6. Funds can be transferred, converted, or withdrawn to an external address or bank account.