Sandbox mock data

​

Overview

​

How it works

1. The person entity belongs to an organization that is in sandbox mode.
2. You call POST /api/kyc/validations with that entity’s entityId.
3. The API looks up the entity’s taxId in the sandbox test map (after normalizing: digits and letters only).
4. If there is a match, a mock validation is created with pending status (201 Created) and moments later it’s updated to the final status (e.g. approved, rejected, cancelled).
5. Webhooks are sent to your configured endpoint with the final result.
6. If there is no match, the API follows the normal flow (creates a real verification session and returns providerSessionUrl).

​

Default test values

​

Outcome list (what each number returns)

​

Argentina – DNI (8 digits)

​

Argentina – CUIT (11 digits)

​

Brazil – CPF (11 digits)

​

Brazil – CNPJ (14 digits)

​

Example: approved with RENAPER

1. Create a person entity in sandbox with taxId: 99990001 (or 99.990.001).
2. Call POST /api/kyc/validations with entityId and doubleCheckRenaper: true (body or query).
3. The API returns 201 with the validation; shortly after, the status is approved and the webhook kyc.validation_approved is sent.
4. The webhook payload includes the full validation object, including metadata.responseDoubleChecks.renaper with verified: true, matchResult: "match", personalNumber, idTramitePrincipal, and renaperData (mock registry response).

​

Example response (mock approved)

{
  "id": "uuid",
  "entityId": "uuid",
  "status": "approved",
  "verifiedAt": "2026-02-21T12:00:00.000Z",
  "extractedData": {
    "firstName": "Sandbox",
    "lastName": "User",
    "fullName": "Sandbox User",
    "dateOfBirth": "1990-01-15",
    "documentNumber": "99990001",
    "documentType": "Identity Card",
    "nationality": "AR",
    "gender": "M",
    "age": 34
  },
  "verifiedFields": ["identity_document", "liveness_check", "face_match"],
  "warnings": [],
  "metadata": {
    "doubleChecks": { "renaper": true },
    "responseDoubleChecks": {
      "renaper": {
        "verified": true,
        "matchResult": "match",
        "personalNumber": "99990001",
        "idTramitePrincipal": "987654321",
        "verifiedAt": "2026-02-21T12:00:00.000Z",
        "renaperData": { "id_tramite_principal": "987654321", "apellido": "User", "nombres": "Sandbox", "fecha_nacimiento": "1990-01-15", "dni": "99990001", "..." }
      }
    }
  }
}

​

Custom mock data

​

See also

• Create KYC Validation – How to call the API
• Webhook Integration – Receive validation events in real time