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
}

Associated Token Account (ATA) Creation

Important for Solana Wallets: On Solana, wallets need an Associated Token Account (ATA) to receive SPL tokens like USDC. Orvion automatically handles this for you.

When you link a Solana wallet, Orvion automatically:

Creates a USDC token account (ATA) for your wallet
Covers the account creation cost (approximately $0.40 USD)
Ensures your wallet can receive USDC payments immediately

This happens automatically in the background - you don't need to do anything. Your wallet will be ready to receive payments as soon as it's linked.

Note: This automatic ATA creation works on both Solana mainnet and devnet. The cost is tracked for transparency but is covered by Orvion.

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