Monitoring & observability
How to monitor your Wajub integration in production — key metrics, alerting, Konsole, logs, and what to watch for.
A payment integration is only as good as your ability to detect problems quickly. This page covers what to monitor, how to access the data, and what alerting to set up before going live.
What to monitor
Payment health
| Metric | Why | Where |
|---|---|---|
| Payment success rate | Drop below baseline → provider issue or integration bug | Dashboard → Analytics |
| Failure rate by channel | Identify which operator/country is degrading | Dashboard → Analytics |
| Pending payments > 30min | Stuck payments need investigation | Dashboard → Payments → filter by status |
| Orchestration fallback rate | High fallback rate → primary provider unreliable | Konsole → Routing Log |
Transfer (payout) health
| Metric | Why | Where |
|---|---|---|
| Transfer failure rate | Failed transfers affect your users' cash flow | Dashboard → Transfers |
| Available balance | Low balance → upcoming transfers may fail | Dashboard → Balance |
Webhook health
| Metric | Why | Where |
|---|---|---|
| Failed webhook deliveries | Missed events = missed fulfillments | Konsole → Webhooks |
| Endpoint response time | > 10s → Wajub retries and you get duplicate events | Konsole → Webhooks |
Konsole — real-time debugging
Konsole is your live observability tool:
- API Logs — every request with request body, response, latency, and provider
- Routing Log — which provider was selected, tier score, fallbacks used
- Webhook Tester — delivery attempts, response codes, retry history, manual replay
- Event Stream — live feed of all events as they happen
Bookmark Konsole
Konsole is the fastest way to debug a failing payment. Instead of reading logs, you see the exact request/response pair, the orchestration decision, and the webhook delivery status in one place.
Setting up alerts
Payment failure spike
Configure an alert in Dashboard → Analytics → Alerts when the failure rate for any channel exceeds your baseline by more than 20% over a 15-minute window.
Webhook endpoint down
Configure an alert when your webhook endpoint returns 5xx for more than 2 consecutive
deliveries. Use Konsole → Webhooks to resend
missed events once the endpoint recovers.
Balance threshold
Configure a low-balance alert in Dashboard → Balance → Alerts to get notified before your available balance drops below the level needed for upcoming scheduled transfers.
Dashboard reports
The Dashboard provides exportable reports for:
- Transaction history — filterable by date, status, channel, country
- Settlement reports — what was settled, when, and at what fee
- Tax reports (if Tax is enabled) — collected tax by period and jurisdiction
- Reconciliation exports — CSV for accounting integration
See Dashboard → Reports for the full reference.
External monitoring
For production-grade monitoring, integrate Wajub data into your existing observability stack:
// Poll /payments with a cursor to count failures in the last 15 minutes
const since = new Date(Date.now() - 15 * 60_000).toISOString();
const { transactions } = await wajub.payments.list({
created_after: since,
per_page: 100,
});
const total = transactions.length;
const failed = transactions.filter(t => t.status === 'failed').length;
const failureRate = total > 0 ? (failed / total) * 100 : 0;
// Push to DataDog / Prometheus / CloudWatch
metrics.gauge('wajub.payment.failure_rate', failureRate, { env: 'production' });Service status
Wajub's platform status (incidents, degradations, maintenance windows) is published at:
status.wajub.com — subscribe to email or webhook notifications for real-time incident alerts.
Was this page helpful?