@verifico/web-api

Este paquete proporciona el cliente de conexión a la API de Verifico desde el navegador.

Se recomienda el consumo de la API de Verifico desde el lado del servidor, sin embargo se proporciona también este paquete del lado del usuario final para clientes que desean una menor latencia en la conexión a la API.

Instalación

npm i @verifico/web-api

Uso

Como buena práctica de seguridad se recomienda que la llave de conexión a Verifico sea obtenida desde el servidor una vez se inicie la sesión del usuario. Si la autenticación se hace mediante tókenes JWT, puede hacer uso de campos persoanlizados (Private claims) para almacenar esta información, así como los identificadores del grupo de entes y del ente.

Ejemplo de uso para un comercio electrónico:

import {
	Cliente,
	Evento,
	Variables,
	VariableOrigen,
	VariableCoordenadas,
	VariableDispositivo,
	VariableAdquisicion,
	VariablePago,
	VariablePrecio,
	VariableTarjetaDePago,
	VariableReceptorDeFacturacion,
	VariableDestinatarioDeEnvio,
	VariableDireccionPostal
} from "@verifico/web-api"

let llave = '<LLAVE_DE_AUTORIZACIÓN_DE_API>'
let grupoDeEntes = '<IDENTIFICADOR_DE_GRUPO_DE_ENTES>'
let ente = '<IDENTIFICADOR_DE_ENTE>'

let direccionIP  = "1.2.3.4"
let coordenadas  = new VariableCoordenadas(4.1234, -72.4321)
let origen       = new VariableOrigen(direccionIP, coordenadas)

let dispositivo  = new VariableDispositivo()

let precio       = new VariablePrecio("COP", "64000")
let tarjeta      = new VariableTarjetaDePago("12/24", "9876")
let pago         = new VariablePago(precio, tarjeta)
let direccion    = new VariableDireccionPostal("CO", "Bogotá", "Suba", "", "Calle 1 # 2-3")
let receptor     = new VariableReceptorDeFacturacion("Juan Pérez", "1234567890", "3001234567", "[email protected]", direccion)
let destinatario = new VariableDestinatarioDeEnvio("Juan Pérez", "3001234567", "[email protected]", direccion)
let adquisicion  = new VariableAdquisicion(pago, receptor, destinatario)

let otras        = {
	"artículoDeLujo": true,
	"enPromoción": true,
	"intencionesPrevias": 2,
	// Otras variables personalizadas...
}

let variables    = new Variables(origen, dispositivo, adquisicion, otras)

let evento = new Evento(grupoDeEntes, ente, variables)

let verifico = new Cliente(llave)
let identificadorDeEvento = ''

try {
	let res = await verifico.registrarEvento(evento)
	identificadorDeEvento = res.identificador
} catch (e) {
	// Manejar error.
}

let verificado = !res.verificacion.requerida
if (verificado) {
	// Proceder con la compra.
} else {
	// Guardar «identificadorDeEvento».
	// Solicitar verificación de código al usuario.
}

Ejemplo de uso de verificación de código:

let llave = '<LLAVE_DE_AUTORIZACIÓN_DE_API>'
let identificadorDeEvento = '<IDENTIFICADOR_DE_EVENTO_PREVIO>'
let codigo = '<CÓDIGO_INGRESADO_POR_EL_USUARIO>'

let verifico = new Cliente(llave)
let verificado = false

try {
	let verificacion = await verifico.verificarCodigoDeEvento(identificadorDeEvento, codigo)
	verificado = verificacion.valido
} catch (e) {
	// Manejar error.
}

if (verificado) {
	// Proceder con la compra.
} else {
	// Bloquear compra.
}