How to get the API

Three steps. Then verify payments from Node, Python, PHP — anything that can HTTP.

01
Create your account
Open the app from this site and sign up.
02
Generate an API key
Developer → API keys. Copy the vk_live_… secret once.
03
POST /api/v1/verify
Send Bearer token + bank + reference. Optional expectedAmount for paymentConfirmed.

curl

curl -X POST https://liqverify.site/api/v1/verify \
  -H "Authorization: Bearer vk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "bank": "telebirr",
    "reference": "DET8FJGUJ4",
    "expectedAmount": 500
  }'

# → { "ok": true, "paymentConfirmed": true }

What the verify API can do

Same bank-source stack as the website and Flutter app — for your checkout backend.

POST /api/v1/verify

bank + reference (+ optional account/phone). Returns ok, sender, receiver, amount.

expectedAmount

Set what the customer should have paid. paymentConfirmed is true only on match.

Bearer / X-Api-Key

Workspace API keys (vk_live_…). Quota follows your Pro plan.

Webhooks

Push verification.success / verification.failed to your order system.

Extract helpers

Image OCR and PDF extract endpoints feed the same confirm path when you need them.

Idempotent refs

Re-checking a known-good ref can return the prior verified result without hammering the bank.

See ETB plans →