TRtrytoku
Validación de Cuenta Clabe

Verificar BankAccount

Changed on

Registra la verificación de titularidad de una cuenta CLABE mexicana.

Se usa para confirmar que una cuenta existe y que pertenece a la persona declarada. Encola una micro transferencia SPEI hacia la CLABE indicada y el resultado se resuelve de forma asíncrona: se consulta después con el endpoint de detalle o se recibe por webhook. El customer_identifier (CURP o RFC) y el customer_name solo se contrastan contra el CEP cuando se envían. Devuelve el identificador de la BankAccountVerification recién creada.

post/bank-account-verification

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/bank-account-verification
  • 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

account_numberstring required

CLABE de 18 dígitos de la cuenta a verificar. Es el destino de la micro transferencia SPEI; si no es una CLABE válida la petición se rechaza con 400.

customer_identifierstring nullable

CURP o RFC del titular declarado. Solo se contrasta contra el identificador que reporta el CEP cuando se envía; si se omite, la verificación confirma la existencia de la cuenta pero no la titularidad. Cuando cualquiera de los dos lados es una CURP (18 caracteres), la comparación se hace sobre los primeros 10, que ambos formatos comparten.

customer_namestring nullable

Nombre del titular declarado. Solo se contrasta contra el nombre que reporta el CEP cuando se envía, con comparación difusa para tolerar diferencias de formato.

filename_referencestring nullable

Referencia libre con la que agrupar la verificación. Queda disponible como filtro batch_references en el listado de verificaciones.

from_inscriptionboolean

Marca que la verificación nace de una inscripción de cuenta. Con true, si la CLABE ya tiene una verificación previa se reutiliza su resultado en vez de disparar una nueva micro transferencia. Solo aplica en la verificación individual: en el lote las verificaciones recientes se reutilizan siempre.

payment_conceptstring nullable

Concepto con el que viaja la micro transferencia y que ve el titular en su cartola. Si se omite, se usa el configurado para la organización.

referencestring nullable

Referencia numérica de la micro transferencia SPEI. Si se omite, Toku genera una a partir de la fecha de la operación.

tracking_idstring nullable

Clave de rastreo SPEI de la micro transferencia. Si se omite, Toku genera una. Queda disponible como filtro en el listado de verificaciones.

Example request

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

Response

Successful Response

id_bank_account_verificationstring required

Identificador público de la BankAccountVerification creada. Úsalo para consultar su resultado en el endpoint de detalle.

messagestring required

Confirmación fija de recepción.

Example response

{
  "id_bank_account_verification": "bav_pBf2NL0d0gvBM7Ei1E3HIWnTN4W93O",
  "message": "OK"
}

Changes

  • a6ef070075b1Revision changes
    • breaking

      request body became required

    • info

      api operation id verify-bank-account removed and replaced with verify_bank_account

    • 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

      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

      removed 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