Point of Sale (PoS)

View as Markdown

Overview

BlockBee POS (Point-of-Sale)

BlockBee's Point of Sale (PoS) app allows you to accept cryptocurrency payments in physical locations. Perfect for retail stores, restaurants, and any business that needs to process crypto payments in person.

Available on:

Setup

Before you can start using the PoS app, you need to configure your BlockBee account. The setup is similar to Checkout Payments, but you won't need an API key since you'll be using the PoS app interface.

1. Create a BlockBee Account

If you haven't already, sign up for a BlockBee account to get access to the dashboard.

2. Configure Addresses

Set up the cryptocurrency addresses where you want to receive payments at Addresses.

3. Configure Payment Settings

  1. Set Default Currency: Go to Payment Settings and configure your default FIAT currency (USD, EUR, GBP, etc.)
  2. Customize Payment Page: Optionally customize the appearance and branding of your payment pages

4. Configure PoS Usernames

Set up PoS usernames for your employees at PoS Settings.

Access PoS

Android App

  1. Download the BlockBee PoS app directly from BlockBee
  2. Open the app and log in using your PoS username (not your main BlockBee account)
  3. You're ready to start accepting payments

Web App

  1. Navigate to pos.blockbee.io
  2. Log in using your PoS username (not your main BlockBee account)
  3. You're ready to start accepting payments

Create Transaction

Step 1: Enter Amount

  1. Open the PoS app (Android or web)
  2. Enter the payment amount in your configured FIAT currency
  3. Add an optional description for the transaction

Step 2: Generate Payment

  1. Tap "Create Payment" or "Generate QR Code"
  2. The app will create a unique payment address and QR code
  3. Display the QR code to your customer

Step 3: Customer Payment

  1. Customer scans the QR code with their cryptocurrency wallet
  2. Customer sends the exact amount shown
  3. Payment is processed automatically

Complete Payment

Payment Confirmation

  • The PoS app will automatically detect when payment is received
  • You'll see a confirmation message on the screen
  • The transaction is marked as complete

Receipt Options

  • Digital Receipt - Send via email or SMS
  • Print Receipt - If using a connected printer
  • No Receipt - Customer can decline

Transaction History

  • All transactions are logged in the PoS app
  • You can view transaction history and status
  • Export transaction data if needed

Testing Your PoS Setup

Test your PoS app using real cryptocurrency with minimal cost.

1. Use Litecoin for Testing

We recommend using Litecoin (LTC) for testing because:

  • Low transaction fees (typically under $0.01)
  • Fast confirmation times (2.5 minutes average)
  • Real blockchain testing without high costs

2. Test with a Small Amount

  • Create a transaction for a small value (e.g., $2.00)
  • Complete the payment using Litecoin
  • This covers all fees with minimal cost (typically under $0.10)
  • Test both pending and confirmed payment states

3. Testing Checklist

  • ✅ PoS username creation works
  • ✅ App login with PoS username works
  • ✅ Transaction creation works as expected
  • ✅ QR code displays correctly
  • ✅ Payment detection works
  • ✅ Confirmation process completes
  • ✅ Transaction history updates

4. Test Both Platforms

  • Test on Android app
  • Test on web app at pos.blockbee.io
  • Ensure both platforms work consistently