Check Compliance

POST/compliance/checkOpen in the API playground →

Info

Internal endpoint called by Gateway services to verify if a transaction is permissible under current rules.

Request

Authorizationstringheaderrequired

Bearer olive_default_xxx (Internal Service Token)

Body Parameters

subscriber_idstringbodyrequired

Subscriber UUID

amountintegerbodyrequired

Amount in cents

transaction_typestringbodyrequired

Type: P2P, CASH_OUT, PAYMENT

recent_transaction_countintegerbody

Velocity check (last 24h count)

is_new_locationbooleanbody

Geo-velocity check

---

Response

allowedboolean

Transaction allowed?

risk_levelstring

LOW, MEDIUM, HIGH, CRITICAL

violationstring

Rule violated (if allowed=false)

---

Examples

Request

cURL

curl -X POST "https://demo.api.vultlocal.com/api/v1/compliance/check" \
  -H "Authorization: Bearer olive_internal_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "subscriber_id": "sub_abc123",
    "amount": 5000000,
    "transaction_type": "CASH_OUT",
    "recent_transaction_count": 5
  }'

Response

200 Allowed

{
  "allowed": true,
  "risk_level": "LOW"
}

200 Blocked

{
  "allowed": false,
  "risk_level": "CRITICAL",
  "violation": "DAILY_LIMIT_EXCEEDED",
  "limit": 1000000,
  "current": 1500000
}

---

Checks Performed

Check	Description
Limit Check	Is amount within daily/single limits?
Balance Check	Does wallet max balance exceed tier?
Velocity	Too many transactions in short time?
Watchlist	Is user on sanctions list?

---

Errors

Status	Code	Description
400	INVALID_INPUT	Bad request parameters
500	rule_error	rule evaluation failed