Nuvori Lab Investigación aplicada · Solo TEST-MXNEstado del proyecto ↗
Nuvoriby Signiqo
Entrar ↗
Nuvori/DEVELOPERS / 04

DEVELOPERS / 04

Construye sobre contratos claros.

API local versionada, mensajes explícitos y respuestas verificables. Esta documentación corresponde a endpoints implementados en el laboratorio.

Dos motores. Dos propósitos.

Pospago experimental

La wallet y Merchant comparten una cuenta de prueba con límite de 500 TEST-MXN. Disponible no equivale a un depósito ni a saldo bancario.

Transferencia de valor

La demo A → B → C utiliza el motor de monederos, emisión y conciliación del proyecto. Su total inicial es 300 TEST-MXN y está separado de la cuenta pospago.

Contrato HTTP implementado.

Método y rutaEfecto / acceso
GET /api/v1/infoCapacidades; lectura pública
GET /api/v1/stateCuenta; sesión consumer, merchant, developer o admin
POST /api/v1/checkoutCompra: session, id, amount, loseReply
POST /api/v1/recoverRecuperación: session, id original
POST /api/v1/connectionConectividad simulada: session, connected
POST /api/v1/syncConciliación de recibos: session
POST /api/v1/newCuenta ficticia nueva con límite fijo: session
GET /api/experience/demoEstado de la demo de esta sesión
POST /api/experience/demoEscenario fijo: start, ab, recover, bc, reconcile, reset

Manejo de estados y errores.

401 / 403

Sesión ausente, expirada o perfil no autorizado. Nunca almacenar la clave de operador en el navegador.

409 / Resultado ambiguo

Consultar el estado y recuperar la intención original. No reintentar automáticamente un POST ni generar un folio nuevo.

422 / Límite insuficiente

La compra fue rechazada. Revisar disponible e importe; el cliente no ajusta saldos.

Sin comunicación

Mostrar indisponibilidad y bloquear operaciones nuevas. La ausencia de respuesta no demuestra que una operación enviada haya fallado.

Hoja de ruta de integración.

Planificado

SDK y webhooks

Planificados. Actualmente no existen SDK público, claves de API autogeneradas ni webhooks de producción.

Parcial

Canales físicos

Adaptadores APDU/PCSC experimentales. QR, BLE y NFC móvil requieren implementación, permisos y validación.

Explorador de API

Inspecciona las respuestas de lectura reales del sandbox con un perfil de desarrollo.

Explorar ↗

EMPIEZA CON UNA LECTURA

Pequeño por diseño.

Consulta capacidades sin iniciar una operación. Las mutaciones requieren una sesión local autorizada y una confirmación explícita.

Abrir API explorer ↗
const response = await fetch('/api/v1/info', {
  cache: 'no-store',
  credentials: 'same-origin'
});
const info = await response.json();
// TEST-MXN · exponent 0 · physicalPurse false

REVISA ANTES DE CONTINUAR

Confirmar acción