Saltar al contenido principal
La gema oficial de Didit para Ruby. Requiere Ruby 3.1 o una versión posterior y usa net/http de la biblioteca estándar. Consulta la visión general de los SDK de servidor para ver lo que comparten todos los SDK.

Instalación

La gema es didit-sdk en RubyGems. Su código fuente y su registro de cambios están en didit-protocol/sdk-ruby en GitHub. También puedes añadir gem "didit-sdk" a tu Gemfile y ejecutar bundle install. Cárgala con require "didit".

Configurar el cliente

Didit::Client.new lee DIDIT_API_KEY del entorno. Pasa argumentos de palabra clave para sobrescribirla o para definir los ids de organización y de aplicación necesarios para las llamadas con ámbito de aplicación (casos, redes, informes regulatorios). Los campos de la solicitud son argumentos de palabra clave con los mismos nombres que usa la API. Las respuestas son objetos con un método de lectura por campo, [:field] y to_h.

Crear una sesión

Crea una sesión de verificación para un workflow y envía a tu usuario a su URL.

Leer la decisión

Cuando el usuario finalice (o cuando llegue el webhook), lee la decisión. El resultado de cada función es una lista con una entrada por cada nodo del flujo.

Verificar un webhook

Pasa el cuerpo sin procesar, exactamente como lo recibiste, y los encabezados de la solicitud. verify lanza Didit::WebhookVerificationError ante cualquier entrega que no sea válida y reciente. En caso contrario, devuelve un evento tipado.
En Rails, llama a handle_webhook(request.raw_post, request.headers). Mientras rotas el secreto, pasa los dos: [new_secret, old_secret]. Consulta Webhooks para ver los eventos y el esquema de firma.

Analizar una transacción

Envía un pago, una retirada o una transferencia de criptomonedas a monitorización de transacciones. La respuesta incluye su estado y su puntuación de riesgo.

Verificar tokens de Authentication

Didit::Authentication comprueba en tu backend los tokens de acceso que firma tu emisor de Authentication, sin invocar a Didit en cada solicitud. También intercambia códigos, renueva tokens, comprueba y revoca sesiones, y ejecuta autenticaciones reforzadas (step-up).
La verificación de tokens realiza las comprobaciones descritas en Verificar un token en tu servidor, con el emisor y las claves de firma de tu aplicación.

Errores

Listas y archivos

Las páginas de endpoints de servidor de la referencia de la API incluyen un ejemplo en Ruby para su operación. Las excepciones son los endpoints y campos que todavía no incluye ninguna versión 1.0.1, indicados en la visión general.
Última modificación el 1 de noviembre de 2026