Payment Links
Create payment URLs and share them with customers. No coding required — just build a URL and send it via email, messenger, or embed it on your website.
URL Structure
Every payment link follows this format:
https://app.zyrox.io/pay/{merchant}/{invoice}?amount=XX.XX
- merchant — Your merchant slug (set when creating the merchant). Example:
my-store - invoice — Unique identifier for this payment. Use your internal order or invoice number. Example:
INV-2024-001 - amount — Payment amount in USD, passed as a query parameter. Example:
amount=99.99
Note: There is also a legacy URL format with amount in the path:
/pay/merchant/invoice/100. It still works (auto-redirects) but we recommend using the query parameter format above.
Examples
Simple payment ($100)
https://app.zyrox.io/pay/my-store/INV-001?amount=100
Payment with customer email (for receipt)
https://app.zyrox.io/pay/my-store/INV-002?amount=49.99&[email protected]
USDT-only payment on a specific network
https://app.zyrox.io/pay/my-store/INV-003?amount=200&token_symbol=USDT&network_id=3
Subscription payment (monthly)
https://app.zyrox.io/pay/my-store/SUB-001?amount=29.99&subscription=monthly&token_symbol=USDT&network_id=3
Test mode payment
https://app.zyrox.io/pay/my-store/TEST-001?amount=1&test=true
Test payments use testnet networks and do not involve real funds.
Query Parameters Reference
| Parameter | Required | Description |
|---|---|---|
amount | Yes | Payment amount in USD (e.g., 99.99) |
email | No | Customer email for payment receipt |
token_symbol | No | Limit payment to a specific token (e.g., USDT, ETH, BTC) |
network_id | No | Specify blockchain network. See network IDs below |
subscription | No | Billing interval for recurring payments: daily, weekly, monthly, yearly |
test | No | Set to true to use testnet networks (no real funds) |
package_id | No | Custom package/product ID stored in invoice metadata (used by integrations) |
Network IDs
| ID | Network | Type |
|---|---|---|
| 1 | Bitcoin Mainnet | Mainnet |
| 2 | Bitcoin Testnet | Testnet |
| 3 | Ethereum Mainnet | Mainnet |
| 4 | Ethereum Sepolia | Testnet |
| 5 | Tron Mainnet | Mainnet |
| 6 | Tron Shasta | Testnet |
| 42161 | Arbitrum One | Mainnet |
| 8453 | Base | Mainnet |
| 10 | Optimism | Mainnet |
Use Cases
- Email Invoices — Include a "Pay with Crypto" button in your email invoices. Link it to a payment URL with the invoice number and amount.
- Messengers & Chat — Send payment links via Telegram, WhatsApp, or any messaging platform. Customers click and pay in seconds.
- QR Codes — Generate a QR code from the payment URL for in-person payments, printed invoices, or point-of-sale displays.
- Website "Pay" Buttons — Add a payment link as a button on your website. No backend integration needed — just an HTML anchor tag.
Invoice ID Best Practices
- Use descriptive IDs:
ORDER-2024-001,INV-12345 - Each invoice ID must be unique per merchant. Reusing an ID will open the existing invoice
- Allowed characters: letters, numbers, hyphens, underscores
- For Scrile Stream integration, use format:
PAY-{customer_id}-{unique}
© 2026 Zyrox. Simple and secure crypto payment processing.