Inicio rápido

Esta guía te ayudará a comenzar con la integración de Soyio en tu aplicación. Soyio ofrece tres módulos principales:

• Disclosure: Revelación de datos y consentimiento
• Signature: Firma de documentos
• Authentication: Autenticación de usuarios

Pre-requisitos

1. Una cuenta de Soyio. Si no tienes una cuenta, contacta a nuestro equipo a soporte@soyio.id.
2. Credenciales de API
3. Un Webhook configurado en tu cuenta

Ambiente de pruebas

Soyio proporciona un ambiente sandbox para desarrollo y pruebas, el cual puedes usar para probar tu integración antes de ir a producción.

Base URL: https://sandbox.soyio.id

info

El ambiente de pruebas no genera solicitudes reales, por lo que no se generarán documentos firmados, consentimientos, ni se realizarán verificaciones de identidad reales.

Revisa más información en nuestra guía de sandbox.

Instala el SDK

Soyio proporciona SDKs para diferentes plataformas que facilitan la integración con nuestros servicios. Puedes instalar el SDK que mejor se adapte a tus necesidades usando npm:

SDK Web

npm install @soyio/soyio-widget

SDK Mobile

npm install @soyio/soyio-rn-sdk

Crea tu primera solicitud de Disclosure

El siguiente ejemplo muestra cómo implementar una solicitud de revelación de datos hacia el usuario:

1. Crea una solicitud de disclosure desde tu backend:

const response = await fetch('https://sandbox.soyio.id/api/v1/disclosure_requests', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    disclosure_template_id: "dtpl_...",
    user_reference: "user_123",
    user_email: "user@example.com"
  })
});
const { disclosure_request_id } = await response.json();

2. Inicia el widget en tu frontend:

import { SoyioWidget } from "@soyio/soyio-widget";
const widgetConfig = {
  request: "disclosure",
  configProps: {
    disclosureRequestId: disclosure_request_id
  },
  onEvent: (event) => {
    switch(event.type) {
      case 'DISCLOSURE_REQUEST_SUCCESSFUL':
        console.log('¡Proceso completado!');
        break;
      case 'WIDGET_CLOSED':
        console.log('Widget cerrado');
        break;
    }
  }
};
new SoyioWidget(widgetConfig);

Siguientes pasos

1. Explora la documentación detallada de nuestros módulos:

   • Disclosure
   • Signature
   • Authentication

2. Revisa los conceptos fundamentales:

   • Verificación de identidad
   • Consentimiento
   • Agreements

3. Consulta la documentación de la API para más detalles sobre los endpoints disponibles.

¿Necesitas ayuda?

Si encuentras algún problema durante la integración, puedes:

• Contactar a nuestro equipo de soporte vía correo electrónico a soporte@soyio.id
• Consultar nuestros canales de Slack