Terminal & POS Payments

ClapPay Terminal lets you accept card payments in person - at your store, restaurant, market stall, or anywhere you meet customers face-to-face.

• Accept tap (contactless), chip, and swipe payments
• Works with Apple Pay and Google Pay
• All payments show up in your ClapPay Dashboard
• Same low fees as online payments

Step 1: Register the Device

1. Go to Dashboard → Terminal → Readers
2. Click Add Reader
3. Enter the registration code from your device
4. Give it a name (like "Front Counter" or "Mobile 1")

Step 2: Connect to WiFi

Your terminal needs internet to process payments. Connect it to your WiFi:

1. On the terminal, go to Settings
2. Select your WiFi network
3. Enter the password
4. Wait for connection

There are two ways to take payments - from the terminal itself, or from your own app/POS system.

Option 1: From the Terminal

1. Enter the amount on the terminal keypad
2. Customer taps, dips, or swipes their card
3. Terminal shows "Approved" when done
4. Optional: Print or email receipt

Option 2: From Your App (API)

// Create a payment intent
POST /v1/payments

{
  "amount": 2500,
  "currency": "USD",
  "payment_method_types": ["card_present"],
  "capture_method": "automatic"
}

// Then send to the terminal
POST /v1/terminal/readers/rdr_abc123/process_payment_intent

{
  "payment_intent": "pi_xyz789"
}

The terminal will prompt the customer to pay. When they do, you'll get a webhook notification.

Let customers add a tip during checkout:

1. Enable tipping in Settings → Terminal → Tipping
2. Choose tip options (%, fixed amount, or custom)
3. The terminal will show tip screen after amount entry

// Enable tipping via API
POST /v1/terminal/readers/rdr_abc123/process_payment_intent

{
  "payment_intent": "pi_xyz789",
  "tipping": {
    "enabled": true,
    "options": [15, 18, 20, 25]
  }
}

Refund in-person payments the same way as online payments:

1. Find the payment in your Dashboard
2. Click Refund
3. Enter the amount (full or partial)
4. Click Confirm Refund

Refunds go back to the same card that was used. The customer doesn't need to be present.

Give customers a receipt after payment:

• Print - Smart terminals have built-in printers
• Email - Ask for email and send digitally
• SMS - Text the receipt link
• No receipt - Customer can decline

If your internet goes down, some terminals can accept payments offline:

• Payments are stored on the device
• They process automatically when internet returns
• There's a small risk - some cards may decline later

Connect ClapPay Terminal to your point-of-sale system:

• JavaScript SDK - For web-based POS systems
• iOS SDK - For iPad POS apps
• Android SDK - For Android tablets
• Server-driven - Control from your backend

// JavaScript SDK - Connect to reader
const terminal = ClapPayTerminal.create({
  onFetchConnectionToken: async () => {
    const response = await fetch('/connection-token');
    const data = await response.json();
    return data.secret;
  }
});

// Connect to a specific reader
await terminal.connectReader(reader);

// Collect payment
const result = await terminal.collectPaymentMethod(
  paymentIntent.client_secret
);