Proxy Wallets

Managing proxy wallets for payment processing

Proxy Wallets

Proxy wallets are custodial wallets managed by the platform to receive customer payments. This guide explains how to view and manage proxy wallets.

What Are Proxy Wallets?

Proxy wallets:

  • Receive customer payments on behalf of merchants
  • Hold funds temporarily before settlement
  • Are managed by the platform
  • Have unique addresses per payment or namespace

Accessing Proxy Wallets

  1. Click Proxy Wallets in the sidebar under the Ops section
  2. The proxy wallets list displays all wallets in the system
Proxy wallets list

Understanding the Proxy Wallets Grid

ColumnDescription
Wallet IDUnique identifier
AddressWallet address on blockchain
NamespaceWallet namespace or category
ReferenceAssociated reference (payment, merchant, etc.)
NetworkBlockchain network
CreatedWhen the wallet was created

Viewing Proxy Wallet Details

Click on any proxy wallet to see detailed information:

Wallet Information

FieldDescription
Wallet IDUnique identifier
AddressBlockchain address
NamespaceOrganizational namespace
NetworkBlockchain network
ReferenceAssociated entity
CreatedCreation date

Associated Accounts

View accounts linked to this proxy wallet:

  • Settlement accounts
  • Balance accounts
  • Transaction accounts

Pending Payments

View any payments pending to this wallet:

  • Payment ID
  • Expected amount
  • Status

Transactions

View transactions related to this wallet:

  • Incoming (customer payments)
  • Outgoing (settlements, withdrawals)

Wallet Accounts

Each proxy wallet may have multiple associated accounts:

  1. Click on the proxy wallet
  2. Select Accounts tab
  3. View all linked accounts

Account information includes:

  • Account ID
  • Type
  • Balance information
  • Status

Processing Withdrawals

Authorized users can initiate withdrawals from proxy wallet accounts.

⚠️

Warning

Withdrawals move actual funds. Verify all details carefully before proceeding.

Withdrawal Process

  1. Open the proxy wallet details
  2. Select the account to withdraw from
  3. Click Withdraw
  4. Enter withdrawal details:
    • Recipient address
    • Amount
    • Token/currency
  5. Review the details
  6. Click Confirm

Withdrawal Fields

FieldDescription
Recipient AddressDestination wallet address
TokenCurrency/token to withdraw
AmountAmount to send
NetworkBlockchain network

After Withdrawal

Once initiated:

  1. The withdrawal enters processing
  2. A blockchain transaction is created
  3. Track status in the wallet's transaction history
  4. Verify completion on blockchain explorer

Common Tasks

Finding a Wallet by Address

  1. Use global search with the wallet address
  2. Or go to Proxy Wallets and use the Address filter

Checking Wallet Balance

  1. Open the proxy wallet
  2. View the Accounts tab
  3. Check balances for each account
  4. Or navigate to Balances and filter by account

Viewing Wallet Transactions

  1. Open the proxy wallet details
  2. Select the Transactions tab
  3. View incoming and outgoing transactions

Finding Pending Payments

  1. Open the proxy wallet details
  2. Select the Pending Payments tab
  3. View payments awaiting receipt

Permissions

RoleView WalletsProcess Withdrawals
Super AdminYesYes
AdminYesYes
Payment OpsYesNo
Compliance OpsYesNo
CS OpsYesNo
Finance OpsYesNo
View OnlyYesNo

Best Practices

Before Withdrawals

  1. Verify the recipient address — Double-check the destination
  2. Confirm the amount — Ensure the amount is correct
  3. Check the network — Verify the correct blockchain
  4. Document the reason — Know why the withdrawal is needed

Security Considerations

  • Withdrawals are logged with user ID and timestamp
  • Large withdrawals may require additional approval
  • Always verify recipient addresses match expected destinations
  • Report any suspicious withdrawal activity

Related Topics