This is a Binance Pay integration that lets Claude process crypto payments through QR codes. It handles both sending (scanning merchant QR codes, PIX support for Brazil) and receiving (generating payment links). The skill is built around a strict state machine with multiple safeguards: it won't let you skip the decode-purchase-confirm flow, treats all API response fields as untrusted display text to prevent injection attacks, and forces explicit user confirmation before executing payments. The documentation is unusually paranoid about security, which makes sense given it's handling money. Works with vision-capable models for direct QR reading or falls back to clipboard/file decoding. If you're building a payment bot on Binance Pay, this gives you the guardrails.

skills.sh installs
4.7K
GitHub stars
1.2K
last updated
Aug 21, 2026

Install

$ npx -y skills add binance/binance-skills-hub --skill payment-assistant --agent claude-code

Installs into .claude/skills of the current project.

Files

⚠️ 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)

Sponsors

Details

Repository
github.com/binance/binance-skills-hub
Categories
Finance & Trading, Web3 & Blockchain
First seen
May 16, 2026

More from binance/binance-skills-hub

All 28
1himself65 avatarstock-liquidityhimself65/finance-skillsAnalyze stock liquidity using bid-ask spreads, volume profiles, order book depth, market impact estimates, and turnover ratios via Yahoo Finance data. Use this 3.3Kskills.sh installs
2joellewis avatarequitiesjoellewis/finance_skillsAnalyze equity securities, factor models, and equity portfolio construction. Use when the user asks about stocks, equity valuation ratios, index construction me727skills.sh installs
3joellewis avatarfinancial-planning-integrationjoellewis/finance_skillsIntegrate financial planning engines with the advisor technology stack — data flows between planning tools, CRM, PMS, custodians, and aggregation platforms; cap723skills.sh installs
4joellewis avatarexchange-connectivityjoellewis/finance_skillsGuide the design and management of trading venue connectivity and market data infrastructure. Owns the FIX session layer (logon, heartbeats, sequence number gap706skills.sh installs
5htx-exchange avatarusdt-m-futureshtx-exchange/htx-skills-hubHTX USDT-M Futures trading using the HTX API. Authentication requires API key and secret key for certain endpoints. Supports mainnet.132skills.sh installs
6gracefullight avatarFinancial Data Fetchergracefullight/stock-checkerFetches real-time and historical market data, financial news, and fundamental data for trading decisions0skills.sh installs