TRtrytoku
Validación de Cuenta Clabe

Verificar BankAccounts en lote público

Changed on

Registra en un solo lote la verificación de varias cuentas CLABE.

Se usa para verificar muchas cuentas de una vez desde la API pública. Cada elemento del lote se procesa igual que una verificación individual (micro transferencia SPEI y contraste opcional de RFC y nombre). Devuelve la referencia del lote y los identificadores de las verificaciones encoladas; el resultado de cada una se resuelve luego de forma asíncrona. Existe un máximo de verificaciones por petición.

post/bank-account-verification/public-bulk

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/bank-account-verification/public-bulk
  • Auth
    API key in header x-api-key

Headers

x-account-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

Request body

batch_referencestring nullable

Referencia con la que agrupar el lote. Si se omite, se genera una con el formato public-bulk-<uuid>. Se devuelve en la respuesta y queda disponible como filtro batch_references en el listado de verificaciones.

Example request

{
  "batch_reference": "altas-2026-08",
  "verifications": [
    {
      "account_number": "646180157000000004",
      "customer_identifier": "GODE561231GR8",
      "customer_name": "Juan Pérez López",
      "payment_concept": "Verificacion de cuenta",
      "reference": "1108143",
      "tracking_id": "20260811900710TOKU1234567ABCDE"
    }
  ]
}

Response

Successful Response

batch_referencestring required

Referencia del lote. Es la enviada en la petición o, si se omite, una generada con el formato public-bulk-<uuid>.

ids_bank_account_verification_requeststring[] required

Identificadores públicos de las BankAccountVerificationRequests creadas, uno por cada elemento del lote y en el mismo orden.

messagestring required

Confirmación fija de recepción.

Example response

{
  "batch_reference": "public-bulk-3f1c9a20-5f7e-4a1b-9c33-2b8d6e5a1f0e",
  "message": "OK"
}

Changes

  • a6ef070075b1Revision changes
    • breaking

      request body became required

    • breaking

      the request property // became required

    • info

      api operation id verify-bank-account-1 removed and replaced with verify_public_bulk_bank_accounts

    • info

      api tag Validación de Cuenta Clabe added

    • info

      added the new optional header request parameter x-account-key

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      the request property default value was removed

    • info

      the request property default value was removed

    • info

      request property list-of-types was widened by adding types null to media type application/json

    • info

      request property // list-of-types was widened by adding types null to media type application/json

    • info

      request property // list-of-types was widened by adding types null to media type application/json

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • info

      the response's property default value public-bulk-<uuid4> was removed for the status

    • info

      the response's property default value OK was removed for the status