Developers

Event API

REST endpoints over HTTPS returning JSON.

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

EndpointDescription
GET /v1/eventsList 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}/confirmMark as merchant-confirmed (optional request_id, note)
POST /v1/events/{id}/rejectReject a detection (reason required)
GET /v1/payment-requestsList payment requests
POST /v1/payment-requestsCreate a request: amount, account_id, reference, expires_in
GET /v1/devicesList 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.