PrivyPrivy
Sign in
  • Documentation
Back to Documentation
B2B Digital Certificate Issuance Support
OverviewChangelog
Insights API
Face Compare API
    v1
      OverviewQuickstartEnvironmentsAuthenticationRequest FieldsComparison ResultsErrors
KTP OCR API
ID Card Forgery
API Explorer
powered by Zudoku
Sign in
v1

Errors

Code
{ "code": 422, "status": "failed", "message": "face1 is required" }
HTTP statusMeaningCommon messages
400Comparison, billing, or usage processing timed out.access timeout
401Credentials or merchant key could not be authenticated.invalid authorization, invalid merchant key, authentication failed
403The integration cannot use this service or has insufficient balance.forbidden, insufficient balance
422The JSON body, transaction ID, or an image is invalid.See validation messages below.
503The service is under maintenance.service is currently under maintenance

Validation can return:

  • invalid payload
  • empty transaction_id
  • transaction_id length must be between 1 and 255 characters
  • invalid transaction_id
  • face1 is required, face1 invalid, or face1 invalid type
  • face2 is required, face2 invalid, or face2 invalid type
  • invalid size selfie when either decoded image exceeds the configured limit
Last modified on October 23, 2026
Comparison ResultsOverview
JSON