FAQs
What's the difference between payment ID and reference?
- ID (
pay_abc123): Internal identifier, used in database - Reference (
2S-A1B2C3): Human-friendly code for sharing with users
Can users pay more or less than the exact amount?
Yes, with a 2% tolerance. Overpayments are processed normally. Significant underpayments may require manual handling.
What happens if settlement fails?
- System retries automatically
- If retries fail, Telegram alert is sent to admin
- Admin can manually trigger settlement via
/v1/admin/sessions/:reference/settle
How long do payments take?
| Stage | Time |
|---|---|
| Create payment | Instant |
| Detect deposit | 5-60 seconds |
| Confirmations | 1-20 minutes (varies by chain) |
| Fiat settlement | 1-5 minutes |
Can I cancel a payment?
Payments cannot be cancelled once crypto is sent. Before deposit, simply let the payment expire.
What are the minimum/maximum amounts?
- Minimum: Varies by crypto (typically $1 equivalent)
- Maximum: Based on your account tier and daily limits
How do I test in development?
- Use testnet API endpoint (if available)
- Create test API keys with limited permissions
- Use small amounts on mainnet for integration testing