Check Compliance - OLIVE Payment Platform

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
  }'

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

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

POST

compliance

check

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
  }'

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

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

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

Request

string

required

Bearer olive_default_xxx (Internal Service Token)

Body Parameters

string

required

Subscriber UUID

integer

required

Amount in cents

string

required

Type: P2P, CASH_OUT, PAYMENT

integer

Velocity check (last 24h count)

boolean

Geo-velocity check

Response

boolean

Transaction allowed?

string

LOW, MEDIUM, HIGH, CRITICAL

string

Rule violated (if allowed=false)

Examples

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
  }'

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

{
  "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

Authorizations

Authorization

string

header

required

JWT token from admin login for administrative operations. Format: 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Headers

Authorization

string

required

Body

application/json

subscriber_id

string

required

amount

integer

required

transaction_type

string

required

recent_transaction_count

integer

is_new_location

boolean

Response

200 - application/json

Success

The response is of type object.

Compliance

List Alerts

​Request

​Body Parameters

​Response

​Examples

​Checks Performed

​Errors

Authorizations

Headers

Body

Response

Request

Body Parameters

Response

Examples

Checks Performed

Errors