Payment Skill — Setup Guide
Dependencies
Python 3.8+ required.
Python Packages
pip install -r requirements.txtSystem Dependency (QR Decoding)
pyzbar requires the zbar system library:
| Platform | Command |
|---|---|
| macOS | brew install zbar |
| Ubuntu/Debian | sudo apt-get install libzbar0 |
If you see "No QR decoder available", ensure
zbaris installed.
API Credentials
You need a Binance API Key with payment permissions.
Get Credentials
- Binance App → Profile → API Management
- Create a new API Key with payment permissions
- Note down the API Key and Secret
Configure
On first run, the skill auto-creates a config.json template. Edit it with your credentials:
{
"configured": true,
"api_key": "YOUR_API_KEY",
"api_secret": "YOUR_API_SECRET"
}base_url is pre-configured to https://bpay.binanceapi.com by default. Do not modify unless instructed.
Or use environment variables as an alternative:
export PAYMENT_API_KEY='your_key'
export PAYMENT_API_SECRET='your_secret'Verify Configuration
python payment_skill.py --action configPayment Limits (Required for First Use)
Before your first payment, you must configure Agent Pay limits in the Binance App:
- Binance App → Profile → Payment → Agent Pay Settings
- Complete MFA verification
- Set single-transaction limit and daily limit
If you see error
LIMIT_NOT_CONFIGURED (-7100), complete this step first.
Security
- Never commit
config.jsonwith real credentials to git - API credentials are stored locally only
- Never share your API Key and Secret
- Payment always requires explicit user confirmation
- Multiple layers of duplicate payment protection (local state + backend validation)