TabbyPOS x402 Integration Guide

1. Overview

TabbyPOS is a multi-chain crypto payment terminal that supports BNB Chain, Solana, ICP, and IoTeX.
It enables merchants to accept digital assets easily through QR code scanning and automatic on-chain settlement.

Now integrated with the x402 Payment Protocol, TabbyPOS supports smart payment flows — users no longer need to select tokens or enter amounts.
By scanning a single x402 QR code, the wallet automatically recognizes:

• the network
• the asset (token)
• the payment amount
• and the merchant address

and completes the transaction instantly.

2. x402 Payment Flow

1. Merchant generates x402 QR

   x402://{
     "network": "bsc-mainnet",
     "asset": "BEEDOG",
     "payTo": "0xded849dedb95bb59dee408650cc8f4e18bd458f4",
     "maxAmountRequired": "49.95",
     "description": "Payment via TabbyPOS x402"
   }
   

2. Customer scans the QR using a wallet that supports x402 (e.g., Bitget Wallet, OISY Wallet, or compatible x402 SDKs)

3. Wallet parses parameters, confirms payment details automatically

4. User clicks confirm, and the transaction is broadcasted on-chain

5. TabbyPOS server listens for on-chain confirmation and updates payment status in real time

3. Integration Example (TypeScript / Node.js)

import express from "express";
const app = express();

app.get("/generate-x402", (req, res) => {
const x402 = {
  network: "bsc-mainnet",
  asset: "BEEDOG",
  payTo: "0xded849dedb95bb59dee408650cc8f4e18bd458f4",
  maxAmountRequired: "49.95",
  description: "Payment via TabbyPOS x402"
};
res.send(`x402://${JSON.stringify(x402)}`);
});

This endpoint can be used by your POS frontend to generate QR codes dynamically for each transaction.

4. Verification Endpoint (Optional)

TabbyPOS backend can expose an endpoint to verify the payment result:

POST /api/v1/payment/verify
{
  "txHash": "0x1234abcd...",
  "network": "bsc-mainnet",
  "asset": "BEEDOG"
}

Returns:
{
  "status": "confirmed",
  "timestamp": "2025-10-27T10:21:00Z"
}

5. Demo Video