Validator: Flujo

Una ✅🤝 Validación en Shinkansen es un chequeo de la existencia de una cuenta y la comprobación de datos asociadas a ellas, como el titular (siempre que los bancos receptores realicen dicha comprobación al recibir fondos).

Para realizar esta validación, Shinkansen típicamente realiza una transacción de muy poco valor a la cuenta destino.

🥑

Validator es nuestra API más simple.

A diferencia de las otras APIs de Shinkansen, Validator no usa el formato de mensajes con transacciones o respuestas o notificaciones. Ni firmas digitales RSA. Dado que no hay dinero de nuestros clientes involucrado, esta API es aún mas simple de usar que el resto de nuestros productos.

Pero eso significa que tienes que estar atento a las diferencias, por lo que te recomendamos leer toda la documentación del producto 👀.

Una cosa que no cambia es la eficiencia, por lo que la comunicación es asíncrona: las respuestas a las validaciones son entregadas en un webhook del cliente (aunque también pueden ser consultadas a través de un endpoint).

Desde el punto de vista de quien requiere una Validación, el flujo es el siguiente:

sequenceDiagram
  autonumber
    Cliente-)Shinkansen: POST /v1/validation/requests
    Shinkansen--)Cliente: POST /webhooks/validations

🔐

¿Y es seguro Validator aunque el API sea más sencilla?

Claro que sí. El API es mas sencilla porque Validator no maneja fondos ni saldos de nuestros clientes. Pero sabemos que viaja información importante de todas formas y esa información debe ser resguardada. Por eso Validator usa siempre TLS (HTTPS) además de API Keys para autenticar peticiones. Para las invocaciones a los webhooks de nuestros clientes, se envía una firma HMAC para asegurar la integridad y autenticidad de dichas respuestas.