QR Scanner


description: Use the native QR scanner for quick transactions

QR Scanner

📷 Scanner Overview

DropFi's QR scanner uses your device's native camera for lightning-fast scanning:

⚡ Instant Detection
Scans in milliseconds
🌙 Low Light Mode
Works in dark environments
📐 Any Angle
No perfect alignment needed
🔍 Smart Recognition
Validates XRPL format

🚀 Accessing the Scanner

Method 1: Scan Tab

The primary scanner access:

  1. Tap "Scan" tab (bottom navigation)
  2. Camera opens immediately
  3. Point at QR code
  4. Auto-processes on detection

Method 2: Send Screen

While sending XRP:

  1. On recipient field
  2. Tap camera icon 📷
  3. Scanner launches
  4. Scans and returns to send

Method 3: Quick Actions

From anywhere on device:

iOS:

  • 3D Touch/Long press app icon
  • Select "Scan QR Code"
  • Opens directly to scanner

Android:

  • Long press app icon
  • Choose "Scan" shortcut
  • Instant camera access

Method 4: Widget

iOS Widget:

  1. Add DropFi widget
  2. Tap scan button
  3. Opens app to scanner
  4. Ready to scan

Android Widget:

  1. Add to home screen
  2. Tap QR scanner icon
  3. Direct camera launch
  4. No loading screens

📱 Scanner Interface

Camera View

Full-Screen Display:

  • Maximum scanning area
  • Minimal UI overlay
  • Focus on QR detection
  • Clean, distraction-free

Visual Elements:

  • Viewfinder Frame: Shows scan area
  • Corner Markers: Animated guides
  • Status Text: "Scanning..." indicator
  • Flash Toggle: For dark conditions
  • Gallery Button: Import from photos

Scanning Animation

Detection Process:

  1. Searching: Pulsing corners
  2. Found: Green flash
  3. Processing: Loading spinner
  4. Success: Checkmark appears

Haptic Feedback:

  • Light tap on detection
  • Strong buzz on success
  • Error vibration pattern
  • Satisfying interaction

🎯 QR Code Types

Standard Address QR

Format:

text
rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH

Contains:

  • XRPL address only
  • Most common type
  • Universal compatibility
  • Simple and clean

When Scanned:

  1. Address extracted
  2. Validates format
  3. Returns to send
  4. Pre-fills recipient

Enhanced Payment QR

Format:

text
xrpl:rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH?amount=100&dt=12345

Contains:

  • XRPL address
  • Amount (optional)
  • Destination tag (optional)
  • Memo field (optional)

When Scanned:

  1. Parses all data
  2. Pre-fills send form
  3. Shows amount in XRP
  4. Includes tag if present

DropFi Format

Our Enhanced QR:

text
dropzero://pay?to=rN7n7...&amount=50&memo=Coffee

Features:

  • Deep link support
  • Rich metadata
  • App verification
  • Enhanced security

Benefits:

  • One-tap payments
  • Verified merchants
  • Transaction context
  • Receipt tracking

Exchange QR Codes

Special Handling:

  • Detects exchange addresses
  • Prompts for destination tag
  • Shows exchange name
  • Warns about requirements

⚙️ Scanner Settings

Camera Permissions

First Time Use:

  1. Permission prompt appears
  2. "DropFi needs camera access"
  3. Tap "Allow"
  4. Scanner ready

If Denied:

  1. Shows permission screen
  2. "Enable Camera Access"
  3. Opens system settings
  4. Toggle permission ON

Scanner Options

In Settings → Scanner:

🔊 Sound Effects
Beep on successful scan
Default: ON
📳 Haptic Feedback
Vibrate on detection
Default: ON
🌙 Auto-Brightness
Boost screen in dark
Default: ON
🔄 Continuous Scan
Keep scanning after success
Default: OFF

Advanced Features

Scan History:

  • Last 10 scans saved
  • Quick re-scan option
  • Clear history anytime
  • Privacy focused

Bulk Scanning:

  • Enable continuous mode
  • Scan multiple codes
  • Queue transactions
  • Process in batch

💡 Pro Scanning Tips

Optimal Conditions

Best Practices:

  • Distance: 6-12 inches
  • Angle: Straight on preferred
  • Lighting: Natural light best
  • Stability: Hold steady briefly
  • Screen QRs: Increase brightness

Difficult Scans

Problem: Won't Scan

Solutions:

  1. Too Close/Far: Adjust distance
  2. Glare: Change angle
  3. Damaged QR: Try photo import
  4. Small QR: Zoom with pinch
  5. Moving QR: Ask to hold still

Problem: Wrong Data

Solutions:

  1. Verify QR is for XRPL
  2. Check complete code visible
  3. Clean camera lens
  4. Update app version
  5. Report if persistent

Flash Usage

When to Enable:

  • Dark environments
  • Paper QRs in shadow
  • Low contrast codes
  • Night transactions

Flash Toggle:

  • Tap lightning icon
  • Auto-remembers preference
  • Adjusts intensity
  • Battery efficient

📸 Import from Photos

When QR is in your photos:

  1. Tap gallery icon 🖼️
  2. Photo picker opens
  3. Select QR image
  4. Processes instantly
  5. Same validation applied

Use Cases

Perfect for:

  • Screenshots of QRs
  • Emailed QR codes
  • Saved payment requests
  • Backup QR images
  • Shared QR photos

Security Note

Safe Practices:

  • Only import trusted QRs
  • Verify sender identity
  • Check amounts carefully
  • Delete after use
  • Don't save sensitive QRs

🛡️ Security Features

QR Validation

Automatic Checks:

  • ✅ Valid XRPL address format
  • ✅ Checksum verification
  • ✅ No malicious data
  • ✅ Proper encoding
  • ✅ Safe URL schemes

Scam Protection

Warning Signs:

  • ⚠️ Suspicious amounts
  • ⚠️ Unknown formats
  • ⚠️ Redirect attempts
  • ⚠️ Non-XRPL data
  • ⚠️ Modified QRs

Protection Features:

  • Known scam database
  • Amount warnings (>1000 XRP)
  • Address verification
  • Manual confirmation required
  • No auto-send ever

Privacy Features

Your Security:

  • No scan history sync
  • Local processing only
  • No cloud analysis
  • Camera only when open
  • No background access

🎬 Quick Workflows

Send to Friend

  1. Friend shows QR
  2. Open Scan tab
  3. Point camera
  4. Green flash = success
  5. Enter amount
  6. Swipe to send

Time: ~10 seconds

Pay Merchant

  1. See QR at checkout
  2. Long press app icon
  3. Tap "Scan QR"
  4. Amount pre-filled
  5. Confirm payment
  6. Show confirmation

Time: ~8 seconds

Request Payment

  1. Open Receive tab
  2. Set amount (optional)
  3. Show QR to payer
  4. They scan with app
  5. Payment arrives
  6. Instant notification

Time: ~15 seconds

🔧 Troubleshooting

Camera Issues

"Camera not available"

  • Close other camera apps
  • Restart DropFi
  • Check iOS/Android permissions
  • Restart device
  • Update OS if needed

"Permission denied"

  1. Go to device Settings
  2. Find DropFi
  3. Enable Camera permission
  4. Return to app
  5. Try scanning again

Scan Failures

QR Not Detecting:

  • Clean camera lens
  • Better lighting
  • Hold steadier
  • Move closer/further
  • Try gallery import

Invalid QR Data:

  • Not an XRPL QR
  • Corrupted code
  • Wrong QR type
  • Get new QR
  • Contact sender

Performance Issues

Slow Scanner:

  • Close background apps
  • Free up storage
  • Update DropFi
  • Check for OS updates
  • Restart device

🌟 Advanced Features

Batch Operations

Multiple Payments:

  1. Enable continuous scan
  2. Scan first QR
  3. Add to queue
  4. Scan next QR
  5. Review all
  6. Send batch

QR Generator

Create Your QRs:

  • Include amount
  • Add description
  • Set expiration
  • Track usage
  • Share easily

Integration

Works With:

  • Point of sale systems
  • Invoice software
  • Payment terminals
  • Other XRPL wallets
  • Web applications

💡 Pro Tip: For the fastest scanning experience, enable "Continuous Scan" mode when paying multiple people or splitting bills. The scanner stays active between scans, making group payments a breeze!