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
}
Compliance
Check Compliance
Validate a transaction against compliance rules
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, PAYMENTinteger
Velocity check (last 24h count)
boolean
Geo-velocity check
Response
boolean
Transaction allowed?
string
LOW, MEDIUM, HIGH, CRITICALstring
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
JWT token from admin login for administrative operations. Format: 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
Headers
Body
application/json
Response
200 - application/json
Success
The response is of type object.
⌘I