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

Errors

Code
{ "code": 422, "status": "failed", "client_transaction_id": "id-forgery-001", "message": "invalid image type image" }
HTTP statusMeaningCommon messages
400A provider, billing, or usage request could not be completed.access timeout
401Basic credentials, merchant key, Bearer token, timestamp, or signature could not be authenticated.invalid authorization, invalid merchant key, authentication failed, invalid token, invalid timestamp, invalid signature
403The integration cannot use this service or has insufficient balance.forbidden, insufficient balance
422The JSON payload, channel, transaction ID, or submitted image is invalid.See validation messages below.
503The service is under maintenance.service is currently under maintenance

Validation returns HTTP 422 with:

  • empty transaction_id
  • transaction_id length must be between 1 and 36
  • invalid transaction_id
  • empty image
  • invalid base64 image
  • image above image size requirement
  • invalid image type image
  • channel length must be between 1 and 100
  • invalid channel
Last modified on October 23, 2026
Forgery ResultsB2B Telco APIs
JSON