Cómo empezar

Para poder acceder al ambiente de pruebas, tu empresa debe haber avanzado en la aceptación de condiciones comerciales. Habiendo resuelto eso, tendrás acceso al entorno de pruebas, el dashboard y también a apoyo nuestro via Slack.

El proceso (un poco mas manual de lo que nos gustaría, mas adelante lo vamos a automatizar) es el siguiente:

1. La persona de contacto a cargo del enrolamiento nos indicará el nombre y correo de dos personas: la encargada de la integración técnica 👩🏻‍💻🧑‍💻 y la encargada de seguridad 👮🏻👮🏻‍♂️. También nos indicará el nombre y correo de sus backups en caso de no estar disponibles.

   👮🏻

   ¿Qué rol cumple la persona encargada de seguridad?

   • Accederá a info sensible para la operación en producción.
   • Será notificada de cambios en certificados en producción y en algunos casos deberá autorizarlos explícitamente.
   • Recibirá recomendaciones para velar por la seguridad de la implementación realizada.
   • Será el punto de contacto ante cualquier incidente en la red.
   • Será responsable de notificarnos ante cualquier incidente de seguridad propio para tomar las medidas respectivas para mitigar el impacto de esos incidentes.

2. Vamos a crear canales Slack compartidos con uds, agregando a las personas respectivas (quienes podrán agregar a otras, tomando la responsabilidad de resguardar la información apropiadamente):

   • #shinkansen--{fintech}-devtest: Pruebas y desarrollo
   • #shinkansen--{fintech}-security: Seguridad

   ⚠️

   Deberás configurar tu slack con 2FA.

   De lo contrario no podrás recibir información sensible por esta vía.

3. En el canal #...-devtest recibirán lo siguiente:

   • El identificador de tu empresa en la red Shinkansen (para enviar en el campo header.sender.fin_id de tus mensajes)

4. El encargado de la integración puede obtener directamente desde el Dashboard :

   • Un API Key para pruebas
   • Un archivo PEM con el certificado de Shinkansen
   • Opcionalmente otros certificados (de contrapartes en el entorno de pruebas)

   Además desde el mismo Dashboard puede cargar:

   • Un archivo PEM con su certificado para pruebas. Este certificado puede ser un certificado autofirmado.
   • La URL para webhooks en entorno de desarrollo.

   ℹ️

   Todas estas llaves y certificados son sólo para desarrollo y pruebas. No pueden ser usados en producción.

5. Dependiendo del lenguaje de programación y stack que uses, nos puedes solicitar ejemplos de código (si ya los hemos desarrollado). También podemos enviarte una colección postman para ayudar con las pruebas.

6. Cualquier duda sobre el API o la integración la conversamos en el canal #...-devtest.

7. Cualquier duda sobre seguridad la conversamos en el canal #...-security.

8. Si necesitas hacer pruebas de stress, coordinemos en #...-devtest.

Puedes encontrar más información sobre las pruebas y casos de borde en https://docs.shinkansen.tech/docs/probar-casos-de-error y sobre como reaccionar a distintos tipos de errores en https://docs.shinkansen.tech/docs/payouts-manejo-de-errores