Validaciones
Validar cuentas
En simple: revisa que una cuenta bancaria exista antes de pagarle y, cuando el banco lo informa, que sea de la persona o empresa indicada.
- Sirve para no pagarle a la cuenta equivocada, por un error de digitación o por fraude.
- Usa las mismas conexiones con los bancos que Payouts, así que detecta los mismos errores que después harían fallar un pago.
- Se puede usar sin Payouts, por API o subiendo un Excel en el Dashboard.
- Disponible en Chile, México y Perú. En Perú valida cuentas de BCP, Interbank y BBVA.
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:
🔐 ¿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.
Docs detallados de APIs relacionadas
Crear una validación
POST /v1/validation/requests/
Recibir resultado de validacion (webhook, recomendado)
POST /from/shinkansen/to/your/webhook/url
Obtener estado de validación (polling, no recomendado)
GET /v1/validation/requests/{id}
