{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/toku/json-schema/toku-beneficiary-accounts-verifications-by-batch-response-schema.json",
  "title": "BeneficiaryAccountsVerificationsByBatchResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/toku-beneficiary-accounts-api-openapi.yml#/components/schemas/BeneficiaryAccountsVerificationsByBatchResponse",
  "properties": {
    "total_count": {
      "default": 0,
      "description": "Total de verificaciones del lote, no solo las de esta página.",
      "title": "Total Count",
      "type": "integer"
    },
    "verifications": {
      "description": "Verificaciones de la página solicitada.",
      "items": {
        "$ref": "#/$defs/BeneficiaryAccountVerificationByBatchItem"
      },
      "title": "Verifications",
      "type": "array"
    }
  },
  "type": "object",
  "$defs": {
    "BeneficiaryAccountVerificationByBatchItem": {
      "description": "El resultado de la verificación bancaria de una Beneficiary Account dentro de un lote.",
      "properties": {
        "account_number": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Número de la cuenta bancaria. Viene `null` en una cuenta de efectivo, que paga al beneficiario en efectivo y no tiene cuenta bancaria de destino.",
          "title": "Account Number"
        },
        "beneficiary_account_external_id": {
          "description": "Identificador de la cuenta en el sistema de origen.",
          "title": "Beneficiary Account External Id",
          "type": "string"
        },
        "beneficiary_external_id": {
          "description": "Identificador del Beneficiary en el sistema de origen.",
          "title": "Beneficiary External Id",
          "type": "string"
        },
        "beneficiary_name": {
          "description": "Nombre del Beneficiary dueño de la cuenta.",
          "title": "Beneficiary Name",
          "type": "string"
        },
        "id_beneficiary": {
          "description": "Identificador del Beneficiary dueño de la cuenta.",
          "format": "uuid",
          "title": "Id Beneficiary",
          "type": "string"
        },
        "id_beneficiary_account": {
          "description": "Identificador de la Beneficiary Account.",
          "format": "uuid",
          "title": "Id Beneficiary Account",
          "type": "string"
        },
        "invalid_reason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Motivo por el que la verificación quedó inválida; `null` cuando no lo está.",
          "title": "Invalid Reason"
        },
        "received_at": {
          "anyOf": [
            {
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Momento en que se recibió el resultado de la verificación.",
          "title": "Received At"
        },
        "requested_at": {
          "anyOf": [
            {
              "format": "date-time",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Momento en que se solicitó la verificación.",
          "title": "Requested At"
        },
        "status": {
          "allOf": [
            {
              "$ref": "#/$defs/VerificationStatus"
            }
          ],
          "description": "Estado de la verificación bancaria de la cuenta. Nace en `PENDING_VERIFICATION`, queda en `PROCESSING` mientras se espera el resultado, y termina en `VALIDATED`, que la habilita para recibir pagos, o en `INVALID`, que la deja rechazada. Editar los datos bancarios la devuelve a `PENDING_VERIFICATION` y reinicia el ciclo. La verificación automática hoy corre solo en México."
        },
        "tokenized_account_number": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "Token que reemplaza al número de cuenta cuando la cuenta ya fue tokenizada. Viene `null` mientras no lo esté y en una cuenta de efectivo, que no tiene número que tokenizar.",
          "title": "Tokenized Account Number"
        }
      },
      "required": [
        "id_beneficiary_account",
        "id_beneficiary",
        "beneficiary_external_id",
        "beneficiary_account_external_id",
        "beneficiary_name",
        "status"
      ],
      "title": "BeneficiaryAccountVerificationByBatchItem",
      "type": "object"
    },
    "VerificationStatus": {
      "description": "Estado de la verificación bancaria de un Beneficiary Account. La cuenta nace en `PENDING_VERIFICATION`, queda en `PROCESSING` mientras se espera el resultado, y termina en `VALIDATED`, que la habilita para recibir pagos, o en `INVALID`, que la deja rechazada. Editar los datos bancarios la devuelve a `PENDING_VERIFICATION` y reinicia el ciclo.\n\nLa verificación automática hoy corre solo en México; en Chile la cuenta se queda en `PENDING_VERIFICATION` hasta que un operador la aprueba o rechaza.",
      "enum": [
        "PROCESSING",
        "VALIDATED",
        "INVALID",
        "PENDING_VERIFICATION"
      ],
      "title": "VerificationStatus",
      "type": "string"
    }
  }
}