Preguntas abiertas
Diez preguntas que siguen sin resolverse a propósito: cada una es una decisión de Nexa o una decisión conjunta, y cada una se referencia desde el punto del portal donde tiene efecto. Esta página es la agenda de la reunión técnica conjunta.
1. Validez de la cotización
¿Qué ventana de expires_at puede ofrecer Nexa, fija o dependiente de la
liquidez?
Tiene efecto en: 1 · Cotización y aceptación ·
POST /v1/quotes [N]
2. Plazo de depósito y semántica de la acreditación
¿Cuánto tiempo mantiene Nexa el tipo de cambio fijado mientras espera el
primer depósito? ¿Un additional_funds_requested lo extiende? ¿Qué
significan exactamente credit.sent y credit.confirmed dentro del core
bancario de Nexa, y cuál es la diferencia de tiempo esperada entre ambos?
Tiene efecto en: 1 · Cotización y aceptación ·
3 · Decisión de acreditación ·
POST /v1/quotes/{tesser_quote_id}/accept [N]
3. Reglas de la decisión de acreditación y SLA
Dado que los depósitos son reportes, ¿cuáles son las reglas de decisión de Nexa, es decir cuándo acredita lo cotizado, cuándo acredita a prorrata, cuándo pide más fondos y cuándo rechaza? ¿Y con qué rapidez recibe Tesser un evento de decisión después de un reporte de depósito?
Tiene efecto en: 2 · Reporte de depósito ·
3 · Decisión de acreditación ·
POST /v1/quotes/{tesser_quote_id}/deposits [N]
4. Destino de los depósitos rechazados
Cuando Nexa rechaza, ¿qué pasa operativamente con el USDC que ya está en custodia? (Es un runbook fuera de banda, pero debe existir antes del primer GTQ en producción.)
Tiene efecto en: 2 · Reporte de depósito · 3 · Decisión de acreditación · Ciclo de vida
5. Redes de pago y estados
¿Qué red o redes de pago guatemaltecas se usarán? Confirmar que un
desembolso se puede ejecutar y confirmar de forma sincrónica dentro del
presupuesto de tiempo de una llamada a la API, cuánto tiempo después de una
respuesta COMPLETED todavía puede aparecer una falla, si RETURNED existe
realmente en esa red, el tiempo de liquidación esperado y el contenido de
status_metadata.
¿Puede Nexa implementar la unión del reintento? Una llamada que expira a
mitad de la ejecución deja a Tesser sin resultado, así que un reintento con
el mismo tesser_quote_id debe unirse a la ejecución que ya está en
curso y devolver su resultado final, en lugar de iniciar un segundo
desembolso. Si Nexa no puede implementarlo, la alternativa registrada es
rechazar el reintento con 409 PAYMENT_IN_PROGRESS y que Tesser consulte en
su lugar la
lectura de la cotización [N].
La reunión debe elegir una de las dos opciones.
Tiene efecto en: 4 · Desembolso en GTQ ·
POST /v1/payments [N]
6. Emisor de webhooks de Nexa
Política de reintentos y de espera entre ellos, y confirmación de que Nexa presenta su certificado de cliente al entregar webhooks, tal como se asume en el diseño de autenticación.
Tiene efecto en: Guía de webhooks ·
POST /v1/webhooks/nexa/{organizationId} [T]
7. Recuperación ante fallas
Confirmar el manejo manual de PAYMENT_FAILED/RETURNED para la prueba de
concepto, sin semántica de reintento por API.
Tiene efecto en: 4 · Desembolso en GTQ · Ciclo de vida
8. Confirmación de autenticación
Nexa aprueba mTLS más una llave de API por cliente, y elige entre fijar la huella digital o validar contra una CA para el certificado de cliente de Tesser.
Tiene efecto en: Autenticación
9. Mecánica de los fondos adicionales
¿usdc_additional_requested es vinculante o indicativo? ¿Puede Nexa
cancelar la solicitud y acreditar de todas formas?
Tiene efecto en: 3 · Decisión de acreditación ·
POST /v1/quotes/{tesser_quote_id}/deposits [N]
10. Ambientes
Disponibilidad del sandbox de Nexa, nombres de host de ambos lados y necesidades de listas de IP permitidas (según el resumen no hay VPN, pero los bancos suelen exigir listas de IP de todas formas).
Tiene efecto en: Autenticación