Developers

Documentation

Everything you need to integrate safely.

Data semantics

A detection is created from a device notification. Its source is always android_notification or provider_api, and verified_by_bank is always false — Wolet has no access to bank ledgers. utr is null when the notification doesn't contain one. Show these states honestly in your UI.

Error codes

HTTPcodeMeaning
invalid_request400A parameter is missing or malformed
unauthorized401Missing or invalid API key
plan_required403Your plan doesn't include API access
not_found404The resource doesn't exist
already_decided409Event already confirmed or rejected
duplicate_suspected422Confirming would duplicate another confirmed event
rate_limited429Too many requests — retry after the Retry-After header
internal_error500Something went wrong on our side

Rate limits

600 requests per minute per live key, 120 per sandbox key.

Sandbox vs live

SandboxLive
Key prefixwlt_test_wlt_live_
DataGenerated demo eventsYour merchants' detections
WebhooksDeliveredDelivered
BillingFreeBusiness plan

Versioning

Breaking changes ship as a new version (/v2). Additive fields can appear at any time — ignore unknown fields.