Beta Feature: Wallets are currently in beta and only available for development instances.
What it is
A wallet is a BlindPay-managed account that lets your customers store stablecoins. You can create one or more wallets per customer to hold, send, and receive digital assets directly within BlindPay. For externally owned, customer-controlled wallets, see Blockchain Wallets.
How it works
Wallets support the following stablecoins:
- USDC
- USDT
- USDB (development instances only)
Available chains:
| Environment | Chains |
|---|---|
| Development | Arbitrum Sepolia, Polygon Amoy (testnet) |
| Production | Arbitrum, Polygon (mainnet) |
Prerequisites
A customer must exist before creating a wallet.
Create a wallet
YOUR_SECRET_TOKEN with your API key and in_000000000000 with your instance ID, and re_000000000000 with your customer ID. Receive stablecoins
You can receive funds from any external blockchain wallet by sending stablecoins to the wallet address provided by BlindPay. Retrieve the wallet details using the API and share the wallet address with the external sender.
You can check the required fields in the BlindPay API Docs.
Remember: replace YOUR_SECRET_TOKEN with your API key, in_000000000000 with your instance ID, re_000000000000 with your customer ID and bl_000000000000 with the wallet ID.
Every time stablecoins are deposited into the wallet, a wallet.inbound webhook event is triggered with the following payload:
Send stablecoins
You can send funds from a BlindPay wallet to other internal BlindPay wallets or external blockchain wallets. Follow these two steps:
- Create a transfer quote — preview the amounts and fees before executing. See the transfer quotes documentation for details.
- Execute the transfer — confirm and move the funds using the quote you created. You have 15 seconds to execute the transfer before the quote expires. See the transfers documentation for details.
Collect fiat
You can collect fiat currency and receive the equivalent stablecoins directly into the wallet. The process is the same as a traditional payin, with one key difference: use wallet_id instead of blockchain_wallet_id when creating the payin quote.
Remember: replace YOUR_SECRET_TOKEN with your API key, in_000000000000 with your instance ID and bl_000000000000 with the wallet ID.
After generating the payin quote, continue to the payins documentation to initiate the payin.
Send fiat
You can use the stablecoins stored in the wallet to send fiat currency to bank accounts. First, create a payout quote exactly as described in the payout quotes documentation.
Then, when creating the payout, use the BlindPay wallet address as the sender_wallet_address.
Remember: replace YOUR_SECRET_TOKEN with your API key, in_000000000000 with your instance ID, qu_000000000000 with the quote ID and sender_wallet_address with the address from your BlindPay wallet.