Blockchain Wallets

External, customer-controlled wallets that receive stablecoins after a payin completes.

What it is

A blockchain wallet is an externally owned wallet that you or your customers control, used to receive stablecoin transfers once a payin completes. For BlindPay-managed wallets that store, send, and receive stablecoins within BlindPay, see Wallets.

How it works

Add one or more wallet addresses where you or your customers want to receive stablecoin transfers. A wallet can be added securely (via a signed message, no manual address entry) or non-securely (by pasting the address directly).

Supported blockchains

See Supported Chains for the full chain and token matrix across all features.

Chain nameChain idInstance type
Ethereum1production
Polygon137production
Base8453production
Arbitrum42161production
Stellar-production
Solana-production
Tron (beta)-production
Ethereum Sepolia (testnet)11155111development
PoS Amoy (testnet)80002development
Base Sepolia (testnet)84532development
Arbitrum Sepolia (testnet)421614development
Stellar Testnet (testnet)-development
Solana Devnet (testnet)-development

Prerequisites

A customer must exist before adding a blockchain wallet.

Add a blockchain wallet (secure)

This method attaches a wallet without entering the address manually. The steps are:

  1. Get the message to sign
  2. Sign the message
  3. Use the signature transaction hash to add the blockchain wallet

To get the message to sign, use the following endpoint:

Remember: replace YOUR_SECRET_TOKEN with your API key and in_000000000000 with your instance ID, and re_000000000000 with your customer ID.
Bash
cURL

Use a library like wagmi or ethers.js to sign the message and get the signature transaction hash.

JavaScript
ethers.js

Use the signature_tx_hash to add the blockchain wallet:

Bash
cURL

Add a blockchain wallet (non-secure)

This method is not recommended because if the funds are sent to the wrong address, the funds will be lost.

Set the is_account_abstraction field to true and fill the address field with the wallet address.

Bash
cURL