Sandbox y pruebas

El ambiente sandbox (-tst) permite integrar y probar de extremo a extremo sin datos productivos.

Credenciales y hosts

• client_id / client_secret de sandbox los entrega BeTrust.
• Hosts: atenea-tst.trust.lat (token), api-tst.trust.lat (API de transacciones), kyc-tst.trust.lat (flujo de verificación).

Datos de prueba

No hay identidades de prueba predefinidas ni fire-webhook: en sandbox se prueba con el flujo real (documento + selfie) usando RUTs válidos. Los distintos resultados del catálogo de estados se obtienen ejecutando el flujo.

Probar el handler de webhook

1. Extremo a extremo: crea una transacción con tu webhook apuntando a tu endpoint y completa el flujo en kyc-tst. Recibirás el POST real.
2. Sin endpoint propio: usa un receptor temporal (p. ej. webhook.site) para inspeccionar el payload entrante.

Checklist de integración

• Token OAuth2 (client_credentials) y refresco antes de expirar.
• Crear transacción con transaction_id único (idempotencia) y metadata correcta.
• Entregar la URL (link/QR) y manejar el handoff desktop→móvil.
• Recibir webhook: handler idempotente, responder 2xx (verificación de firma: roadmap).
• Confirmar estado autoritativo con GET /v1/transactions/{uuid}.
• Recuperar datos del documento con credential_information (si aplica).
• Manejar todos los estados/errores del catálogo.