Wallets

Wallets allow you to connect and verify Solana wallets in Orvion. Once connected, your primary wallet can be used automatically for receiving payments when creating charges.

What are Wallets?

Wallets in Orvion enable:

Wallet verification: Prove ownership of Solana wallet addresses through cryptographic signing
Automatic payment configuration: Use your connected wallet as a fallback for payment receipt
Wallet management: Organize multiple wallets with labels and primary designation
Payment receipt: Receive payments directly to your connected Solana wallet

Connecting a Solana Wallet

Via Dashboard

Navigate to Account → Wallets in the dashboard
Click "Connect Solana Wallet"
Select your wallet provider (Phantom, Solflare, etc.)
Approve the connection request
Sign the verification message to prove wallet ownership

Note: You'll only be asked to sign a message, never to share your seed phrase. The signature is used to verify wallet ownership.

Wallet Verification

When connecting a wallet, Orvion will:

Generate a challenge message
Request your signature on that message
Verify the signature cryptographically
Link the wallet to your account

Once verified, the wallet is marked as Verified and can be used for payment receipt.

Wallet Features

Primary Wallet

You can designate one wallet as your primary wallet. The primary wallet is used automatically when:

Creating charges without specifying a receiver config
No default receiver config exists
You want to use your connected wallet as a fallback

To set a wallet as primary, use the wallet menu (three dots) and select "Set as primary".

Wallet Labeling

Give your wallets descriptive labels to help identify them:

Click the wallet menu (three dots)
Select "Rename"
Enter a label (e.g., "Main Wallet", "Operations", "Treasury")

Labels are for organization only and don't affect functionality.

Multiple Wallets

You can connect multiple Solana wallets to your account. Each wallet:

Must be verified individually through signing
Can have its own label
Can be set as primary (only one primary at a time)
Can be removed independently

Using Connected Wallets for Payment Receipt

When you create a charge without specifying payment configuration, Orvion uses this fallback chain:

Charge request x402 fields (if provided directly)
Receiver config ID (if specified)
Default receiver config (if is_default: true exists)
Connected Solana wallet (if you have a primary wallet connected)
Error (if no configuration found)

Automatic Payment Configuration

If you have a primary Solana wallet connected, it will be used automatically with:

Network: solana-mainnet
Asset: USDC
Address: Your primary wallet address

This means you can create charges without manually specifying payment details:

POST /v1/flows/flow_123/charges
{
  "amount": 100,
  "currency": "USD"
  // No payment config needed - uses connected wallet automatically
}

Using Wallets in Receiver Configs

You can also reference your connected wallet address when creating receiver configs:

POST /v1/billing/receiver-configs
{
  "name": "Main Wallet",
  "network": "solana-mainnet",
  "asset": "USDC",
  "pay_to_address": "YOUR_CONNECTED_WALLET_ADDRESS",
  "is_default": true
}

Wallet Management

Viewing Connected Wallets

All connected wallets are displayed in the dashboard with:

Wallet address (truncated for display)
Verification status badge
Primary wallet indicator
Creation date
Custom label (if set)

Removing a Wallet

To remove a wallet:

Click the wallet menu (three dots)
Select "Remove"
Confirm the removal

Note: Removing a wallet doesn't affect past records or transactions. However, it may affect future charges that rely on the wallet for automatic payment configuration.

Security

No seed phrase sharing: You only sign messages, never share your seed phrase
Cryptographic verification: Wallet ownership is verified through cryptographic signatures
Organization scoping: Wallets are scoped to your organization
Revocable: You can remove wallets at any time

Limitations

Solana only: Currently supports Solana wallets only
Dashboard only: Wallet connection is only available via the dashboard UI (not via API)
USDC default: Connected wallets default to USDC on Solana mainnet