payment-assistant

⚠️ CRITICAL: How to Handle QR Images

When user sends a QR code image or asks to pay:

Step 0: Check if user provided a PAYMENT LINK (text, not an image)

If the user provided text (not an image), and the text is a URL containing app.binance.com/uni-qr/ or app.binance.com/qr/:

→ This is a payment link. Skip all decode steps. Go directly to purchase:

python3 payment_skill.py --action purchase --raw_qr "<the URL text>"

Otherwise (user sent an image, or text doesn't match above) → continue to Step 1.

Step 1: Try to READ the QR data directly (Vision)

Look at the QR code image and try to extract the actual data string (URL or EMV code).

• If you can read it → --action purchase --raw_qr "<DATA>"
• If you cannot read the data (only see logo/colors) → Go to Step 2

Step 2: Check for image file path

Does your platform provide the image attachment path in message metadata?

• If YES → --action decode_qr --image "<PATH>"
• If NO → Go to Step 3

Step 3: Ask user for help (DO NOT auto-use clipboard!)

"I cannot read the QR directly. Please copy to clipboard, then reply 'use clipboard'"

(Translate to user's language as needed)

Step 4: Only after user confirms → use clipboard

python3 payment_skill.py --action decode_qr --clipboard

---

⛔ FORBIDDEN:

• ❌ --clipboard without user explicitly saying "use clipboard"
• ❌ Guessing or searching for image files
• ❌ Skipping the "ask user" step

✅ REQUIRED after decode_qr succeeds:

• Tell user the image source (e.g., "Decoded from clipboard" or "Decoded from file: xxx.jpg")
• Include source_type from response in your message to user

---

🚀 Quick Start - Agent MUST Execute

When user sends a QR code image or asks to pay:

Step 1 - Get QR Data (Choose ONE method)

Method A: AI Vision (BEST - if your platform supports it)

1. Use your vision capability to read the QR code content directly from the image
2. Skip decode_qr entirely, go straight to purchase with the QR data

python3 payment_skill.py --action purchase --raw_qr "https://app.binance.com/uni-qr/xxx"