Cómo usar el Validador en 🇲🇽

A diferencia de otros países, en México es posible hacer una consulta de información del titular de una cuenta a partir del número. Por lo tanto hay dos formas de usar el Validador en México:

1. Obtener Información del Titular para realizar tus propias verificaciones : No necesitas enviar información del titular de la cuenta. Basta que envíes la CLABE y Shinkansen Validator te retornará la información de su titular (cuando menos el RFC o CURP), para que efectúes todas las validaciones que quieras realizar. Esta opción es recomendada si operas solamente en México y quieres mayor flexibilidad en el uso de nuestro producto.
2. Delegar a Shinkansen la comprobacion: En este caso deberás enviar información del titular y Shinkansen verifica si hay match en el RFC o CURP. Esta opción es recomendada si operas en múltiples países con el validador de cuenta y quieres mantener el mismo modo de uso en México que en otros países.

A continuación de dejamos más detalles de cada modalidad:

1. Obtener Información del Titular para realizar tus propias verificaciones

🇲🇽

Esta es tu opción recomendada si operas solamente en México

En México es común que las empresas quieran validar quién es el titular de la cuenta CLABE a la que le transfieren, dado que no es un requisito incorporar un ID o nombre en las transferencias.

Para satisfacer lo anterior, una ✅🤝 Validación en Shinkansen te permite obtener el RFC/CURP y el nombre del titular de la cuenta con solo proporcionar el número CLABE.

Con esto tendrás certeza de quién es el titular de la cuenta de destino, evitando enviar dinero a personas o empresas equivocadas.

Ejemplo de Request hacia Validator 🇲🇽 en modo Consulta

{
  "account_details": {
    "account": "999000000000000835",
    "account_type": "clabe",
    "currency": "MXN"
  },
  "id": "e60044b2-2ecc-49c2-b20b-b20c07292753"
}

Puede obtener la información del titular cuenta a través de los siguientes campos de la respuesta:

• response.return_code: Si contiene el valor "valid_account_details" significa que la cuenta CLABE existe y por lo tanto Shinkansen enriquecerá la información dentro de account_details.
• account_details.name: Nombre del titular.
• account_details.identification: Tipo de identificación (id_schema puede ser "MXRFC" o "MXCURP") y valor (en el campo id).

Ejemplo de Response de Validator 🇲🇽 en modo Consulta (recibido vía Webhook) — sólo con los campos más relevantes

{
  "account_details": {
    "account": "999000000000000835",
    "account_type": "clabe",
    "currency": "MXN",    
    "name": "Nombre del titular",
    "financial_institution": {
      "fin_id": "BBVA_MEXICO_MX",
      "fin_id_schema": "SHINKANSEN"
    },
    "identification": {
      "id": "ABC100000045",
      "id_schema": "MXRFC"
    },
  },
  "id": "e60044b2-2ecc-49c2-b20b-b20c07292753",
  "status": "performed",
  "response": {
    "return_code": "valid_account_details",
    "invalid_account_details_reason": null,
  }
}

Notar que en este caso el response.return_code siempre será valid_account_details mientras la cuenta CLABE exista. Si no existe, entonces el response.return_code tendrá el valor invalid_account_details.

2. Delegar en Shinkansen la Comprobación

🌎

Esta es tu opción recomendada si ya usas Shinkansen Validator en otros países

Si ya estás usando el Validador en otros países y quieres mantener la lógica universal de entregarle a Shinkansen los datos del titular y que se te indique si corresponden los datos o no, entonces deberás incluir el CURP o el RFC de la persona en el campoaccount_details.identification

Ejemplo de Request hacia Validator 🇲🇽 en modo Verificación

{
  "account_details": {
    "account": "999000000000000835",
    "account_type": "clabe",
    "currency": "MXN",
    "identification": {
      "id": "ABC100000045",
      "id_schema": "MXRFC"
    },      
  },
  "id": "e60044b2-2ecc-49c2-b20b-b20c07292753"
}

📘

Cuando Shinkansen Validator detecta que enviaste un RFC o CURP, opera en modo verificación.

Al operar en modo verificación, Shinkansen no agregará información dentro deaccount_details por lo que tendrás que revisar los siguientes campos en la respuesta:

• response.return_code Si recibes el valor "valid_account_details" entonces hubo match con el identificador que proporcionaste. Si recibes el valor "invalid_account_details" entonces deberás revisar el campo invalid_account_details_reason.
• response.invalid_account_details_reason: Con este campo puedes determinar si la validación arroja cuenta inválida porque la cuenta CLABE no existe (valor "account_not_found" o porque no hubo match en el RFC o CURP (valor "account_detail_mismatch").

Ejemplo de Response de Validator 🇲🇽 en modo Verificación (recibido vía Webhook) — sólo con los campos más relevantes

{
  "account_details": {
    "account": "999000000000000835",
    "account_type": "clabe",
    "currency": "MXN",
    "identification": {
      "id": "ABC100000045",
      "id_schema": "MXRFC"
    },      
  },
  "id": "e60044b2-2ecc-49c2-b20b-b20c07292753",
  "status": "performed",
  "response": {
    "return_code": "valid_account_details",
    "invalid_account_details_reason": null,
  }
}

Tiempos de Respuesta

Las validaciones generalmente tienen respuesta en tan solo unos minutos. En situaciones excepcionales en que el sistema SPEI esté con mayor carga podrían demorar un poco más.

Docs detallados de APIs relacionadas