Authentication
Send your secret key as a Bearer token. Live keys start with wlt_live_, sandbox keys with wlt_test_. Never use keys in browser or mobile code.
bash
Authorization: Bearer wlt_live_8f3k...
Endpoints
| Endpoint | Description |
|---|---|
GET /v1/events | List detection events. Filters: status, provider, branch_id, from, to, limit, cursor |
GET /v1/events/{id} | Fetch one event with its timeline |
POST /v1/events/{id}/confirm | Mark as merchant-confirmed (optional request_id, note) |
POST /v1/events/{id}/reject | Reject a detection (reason required) |
GET /v1/payment-requests | List payment requests |
POST /v1/payment-requests | Create a request: amount, account_id, reference, expires_in |
GET /v1/devices | List paired devices with heartbeat and permission status |
Example: list events
bash
curl "https://api.wolet.in/v1/events?status=detected&limit=20" \ -H "Authorization: Bearer wlt_test_2b9x..."
json
{ "data": [ {
"id": "evt_01JD8X2K7Q",
"type": "payment.detected",
"created_at": "2026-11-17T14:32:08+05:30",
"data": {
"amount": 2450.00,
"currency": "INR",
"provider": "phonepe_business",
"payer_name": "Ravi K.",
"utr": "412839057216", // null when the notification has no UTR
"device_id": "dev_01",
"branch_id": "br_1",
"status": "detected", // detected | confirmed | rejected | review
"source": "android_notification",
"verified_by_bank": false
}
} ], "next_cursor": "c_9a1" }Example: confirm
bash
curl -X POST https://api.wolet.in/v1/events/evt_01JD8X2K7Q/confirm \
-H "Authorization: Bearer wlt_test_2b9x..." \
-d '{"request_id":"req_014","note":"Table 4"}'Confirmation records the merchant's decision. It does not verify the payment with any bank.