FinPa Business Console

Log in to your workspace to generate secure API keys, manage billing, and control team access.

Sign in to Business Console
Auth Required
Safe testing environment. Base URL modifies to sandbox-api.finpa.vn
POST
https://sandbox-api.finpa.vn/v1/business/kyc/verify

Verify Identity (Liveness & OCR)

Uploads an identity document and liveness video for automated Deepfake detection and OCR extraction. Checks directly with VNeID if possible. Compliant with SBV standards and Decree 13/2023/ND-CP.

Authentication & Headers

AuthorizationRequired
Bearer <YOUR_BUSINESS_API_KEY>
Content-TypeRequired
application/json

Request Schema

JSON
{
  "documentFrontImageBase64": "string (required)",
  "documentBackImageBase64": "string (optional)",
  "livenessVideoBase64": "string (required)",
  "referenceId": "string (optional) - Custom trace ID"
}

Error Codes

HTTP 400
Invalid Base64 formats.
HTTP 401
Invalid API Key.
HTTP 422
Liveness test failed (spoof detected).
curl -X POST https://sandbox-api.finpa.vn/v1/business/kyc/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"documentFrontImageBase64": "...", "livenessVideoBase64": "..."}'
200 OK Response
{
  "success": true,
  "transactionId": "txn_89dja81nd1",
  "status": "VERIFIED",
  "data": {
    "idNumber": "001090000123",
    "fullName": "NGUYEN VAN A",
    "dateOfBirth": "1990-01-01",
    "livenessScore": 0.998,
    "isSpoof": false,
    "vneidMatched": true
  },
  "timestamp": "2026-03-02T11:45:00Z"
}
Was this helpful?