Seller Alerts

Know when payments fail before your users complain. Get instant Telegram alerts when something goes wrong with payments to your x402-enabled API.

Overview

Dexter monitors every transaction through the facilitator and alerts you when something needs attention. We filter out noise (like buyers with empty wallets) and only notify you about actionable issues.

What You'll Get Notified About

What You WON'T Get Notified About

• Buyer has no funds - Not your problem. The buyer's wallet is empty.
• No token account - Buyer never had USDC. Not actionable for you.

Setting Up Telegram Alerts

Step 1: Start the Bot

Open Telegram and start a chat with @DexterAISolBot.

Step 2: Link Your Wallet

Send the /link command. You'll receive a verification code to sign with your wallet.

/link

The bot will respond with:

🔗 Link your wallet to Telegram

Sign this message with your seller wallet:
"Dexter Telegram Verify: ABC123"

Then send: /verify ABC123 <signature>

Step 3: Sign and Verify

Sign the message using your wallet (Phantom, Solflare, etc.) and send the verification:

/verify ABC123 <your-signature>

Once verified, you'll receive alerts automatically.

Step 4: Test Your Setup

Send /seller to see your dashboard and verify everything is connected:

/seller

Understanding Alert Messages

Example: Setup Issue

⚙️ Payment Failed - Setup Issue

Time: 2 minutes ago
Error: fee_payer_not_managed

What happened:
Your x402 setup has a configuration problem - check 
your facilitator URL or payment requirements.

💡 What to do: Check your facilitator URL and payment 
config. Docs: dexter.cash/docs

Use /seller to check your dashboard.

What this means: Your server is requesting a fee payer that isn't registered with the facilitator. Double-check your x402 integration.

Example: Bad Transaction

🔧 Payment Failed - Transaction Issue

Time: Just now
Errors: 3 in the last minute
  • 2x Bad Transaction
  • 1x Network Slow

What happened:
The payment transaction was built incorrectly. This 
usually means something in your code needs fixing.

💡 What to do: Check your x402 integration code. 
Docs: dexter.cash/docs

Use /seller to check your dashboard.

What this means: The transactions your buyers are creating have invalid instructions or account references. Review your client-side code.

Example: Network Slow

🐢 Payment Delayed - Solana Was Slow

Time: 5 minutes ago
Error: BlockhashNotFound

What happened:
Solana was congested. The transaction took too long 
and expired. Not your fault.

💡 What to do: Buyer can retry - it should work now.

Use /seller to check your dashboard.

What this means: Nothing is wrong with your code. Solana was just slow. The buyer can retry and it will likely succeed.

Alert Batching

To avoid spam, alerts are batched:

• Within 1 minute: Multiple errors from the same seller are grouped into one message
• During network issues: If Solana is having a network-wide problem, individual "Network Slow" alerts are suppressed (you'll see a global status instead)

Bot Commands

Seller Dashboard (/seller)

The /seller command shows:

📊 Your Seller Dashboard

💰 Revenue (24h): $142.50
📈 Settlements: 847 successful
❌ Errors: 12 (1.4%)

Recent Errors:
• 2m ago 🐢 Network Slow
• 5m ago 🐢 Network Slow  
• 8m ago ⚙️ Setup Issue

🐢 Verdict: Solana was slow

[📈 Dashboard] [🔄 Refresh]

System Health (/x402health)

Check overall facilitator status:

✅ x402 Facilitator ✅

Status: OPERATIONAL
🟩🟩🟩🟩🟩🟩🟩🟩🟩🟩 100%

📊 Last 5 Minutes
├ Total ops: 3,624
├ Errors: 12 (0.3%)
│
├ 🔧 System: 2
│  └ Blockhash expired: 2
│
└ 👤 User: 10
   └ No funds: 8
   └ No token acct: 2

📅 Last 24 Hours
├ 847,293 ops · $12.4K volume
├ Errors: 2,341 (0.3%)
├ 🔧 System: 341
└ 👤 User: 2,000

The health check distinguishes between:

• System errors (🔧): Issues that might affect you - network, connection, our bugs
• User errors (👤): Buyers without funds - not actionable

Error Reference

🔧 Bad Transaction

Cause: Transaction instructions are malformed or reference invalid accounts.

Common fixes:

• Ensure you're using the correct token mint (USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v)
• Verify account addresses are valid Solana public keys
• Check that the payer has an associated token account

⚙️ Setup Issue

Cause: x402 protocol configuration problem.

Common fixes:

• Verify facilitatorUrl points to https://x402.dexter.cash
• Check that payTo is your correct wallet address
• Ensure payment requirements match your pricing
• Verify the signature scheme matches your network (Solana vs Base)

🐢 Network Slow

Cause: Solana network congestion caused the transaction to expire.

Not your fault. Buyer should retry. If this happens frequently during normal network conditions, consider:

• Using priority fees
• Implementing retry logic on the client side

📡 Connection Issue

Cause: Temporary network connectivity problem.

Usually resolves itself. If persistent, check status.solana.com for network issues.

🔴 Our Problem

Cause: Internal facilitator error.

We're on it. No action needed from you. Our team is automatically notified and investigating.

Rate Limits & Caps

Each seller has daily usage caps to prevent runaway costs:

View your current usage against these caps at dexter.cash/seller or via /seller in Telegram.

Need Help?

• Docs: dexter.cash/docs
• Telegram: @dexteraisol
• Twitter: @dexteraisol
• Email: [email protected]