What is Recivr
Recivr provides real-time payment fee calculation for Visa and Mastercard transactions. A single API call returns the full IC++ cost breakdown:
- Scheme fees — per-transaction fees charged by Visa/Mastercard (percentage, flat, and tiered)
- Fixed fees — recurring fees (monthly, annual) allocated per-transaction
- Interchange fees — fees paid to the card issuer, resolved via IRD-based lookup
How It Works
Your system sends a transaction payload — card BIN, amount, currency, merchant country, MCC, and transaction metadata. Recivr returns a structured response with:
- Total fees by currency
- Total fees converted to the transaction currency
- Card details (auto-enriched from BIN lookup)
- Region classification (DOMESTIC, INTRA_EEA, INTER_REGIONAL, etc.)
- Per-fee breakdown when requested
Performance
| Metric | Target | Measured |
|---|---|---|
| p50 latency | < 80ms | 50ms |
| p95 latency | < 150ms | 70ms |
| p99 latency | < 200ms | 80ms |
| Availability | 99.99% | — |
The calculation engine is stateless — no database writes on the hot path. Analytics are decoupled via an asynchronous stream, so API latency is never affected by persistence.
Supported Schemes
- Visa
- Mastercard
Calculation Modes
Control what gets calculated with options.mode:
| Mode | Calculates | Typical latency |
|---|---|---|
"all" (default) | Scheme + Interchange + Fixed | 50–80ms |
"scheme" | Scheme + Fixed fees only | 40–60ms |
"interchange" | Interchange only | 30–50ms |
Fee Precision
All fee amounts are returned as strings with 6 decimal places (e.g. "0.025000"). This ensures precision for high-volume aggregation without floating-point errors.
Next Steps
- Quick Start — Make your first API call
- Authentication — JWT tokens and key management
- Environments — Sandbox and production
- API Reference — Complete endpoint documentation