OneSpan Sign Developer: URL de transferencia

Duo Liang, 14 de Febrero de 2020

Imagine que está desarrollando una aplicación integrada con OneSpan Sign. Después de que el firmante haya completado la firma, desea encontrar una manera de sincronizar el cambio de estado de firma y tomar el control del proceso de firma electrónica. Hay algunas tecnologías con las que ya puede estar familiarizado, como configurar un escucha de devolución de llamada o utilizar el notificador de Javascript.

La URL de transferencia, por otro lado, también se puede usar como un enlace web y enviar su solicitud con información en tiempo real cuando el firmante haya completado la firma. En este blog, profundizaremos en los detalles de la URL de transferencia y compartiremos algunos consejos sobre cómo aprovechar esta función en su propia integración. ¡Empecemos!

¿Qué es una URL de transferencia?

Una URL de transferencia es un enlace de redireccionamiento preestablecido en la configuración del paquete, que le permite determinar dónde se reubicará la ceremonia de firma después de que un destinatario interactúe con una transacción. La URL se activará de manera diferente de ciertas maneras. El escenario más común es cuando un firmante ha completado la firma, la URL de transferencia se mostrará como un botón de salida disponible tanto en la barra de acciones globales como en la barra de herramientas.
2-14-1
En otros casos, como cuando un destinatario se niega a firmar una transacción, la URL de transferencia se activará automáticamente.

Configurar URL de transferencia

Hay tres valores que debe especificar con respecto a la URL de transferencia:

• Enlace de transferencia Href : Define la URL de redireccionamiento
• Texto de enlace de transferencia : El texto que aparecerá en el botón de transferencia
• Información sobre herramientas de enlace de transferencia : El texto que aparecerá al pasar el mouse sobre el botón de transferencia

Conocer la URL de transferencia es una configuración de paquete, es posible establecer los valores predeterminados en el nivel de su cuenta. Si su flujo de trabajo simplemente requiere redirigir la ceremonia de firma a una página de finalización general o al sitio web de su organización, puede presentar una solicitud y enviar estos tres atributos a nuestro equipo de apoyo entonces todos los paquetes recién creados heredarán los valores.

Además, si desea especificar diferentes puntos finales o parámetros para cada paquete, establecer la URL de transferencia a nivel de paquete es una forma más flexible de abordarlo.

API REST:

Los atributos se alojan en "configuración"> "ceremonia"> "traspaso". Vea abajo:

{
  "status": "BORRADOR",
  "configuración": {
    "ceremonia": {
      "entregar": {
        "title": "Serás redirigido a la página de inicio de Google",
        "href": "http://www.google.com",
        "text": "Salir al sitio"
      }
    }
  },
  "type": "PAQUETE",
  "nombre": "Personalización de la ceremonia de firma"
}

Desde aquí, el atributo "título" se refiere a la información sobre herramientas del texto.

SDK de Java:

El código equivalente en Java SDK se ve así:

.withSettings (DocumentPackageSettingsBuilder.newDocumentPackageSettings ()
			.withHandOverLinkHref ("http://www.google.com")
			.withHandOverLinkText ("Salir al sitio")
			.withHandOverLinkTooltip ("Serás redirigido a la página de inicio de Google")
		)

.NET SDK:

.WithSettings (DocumentPackageSettingsBuilder.NewDocumentPackageSettings ()
                        .WithHandOverLinkHref ("http://www.google.com")
                        .WithHandOverLinkText ("Salir al sitio")
 	       .WithHandOverLinkTooltip ("Redirigirá a la página de inicio de Google")
 	)

Para leer más

La URL de entrega solo notifica a los usuarios del evento de finalización del firmante. Si está interesado en más opciones de notificación, use la escucha de notificaciones de eventos de devolución de llamada. Puede encontrar más información sobre esta función en la serie de blogs anterior y nuestra guía de funciones:

Notificación de evento de devolución de llamada - Parte 1
Notificación de evento de devolución de llamada - Parte 2
Crear una guía de escucha de notificaciones de eventos de devolución de llamada

Además, si está integrando la Ceremonia de firma en un iFrame, hay otro mecanismo para controlar el proceso de firma a través del notificador de Javascript. Es una solución con código Javascript puro, muy ligero para implementar y probar a través de la salida. Consulte la guía de funciones para ver códigos de muestra y más detalles:

Guía de notificación de eventos de JavaScript

Si tiene alguna pregunta sobre este blog o cualquier otra cosa relacionada con la integración de OneSpan Sign en su aplicación, visite el Foros de la comunidad de desarrolladores . ¡Sus comentarios nos importan!