Primera verificación en 10 minutos

Integra la verificación de identidad con 3 llamadas: autenticar, crear la transacción y consultar el estado. Los hosts de ejemplo son de sandbox (-tst).

Requisitos

client_id y client_secret de sandbox (los entrega BeTrust). Cualquier cliente HTTP (curl/Postman).

1. Obtener un access token

curl --location 'https://atenea-tst.trust.lat/oauth/token/' \
  --header 'Content-Type: application/json' \
  --data '{
    "client_id": "TU_CLIENT_ID",
    "client_secret": "TU_CLIENT_SECRET",
    "grant_type": "client_credentials"
  }'

Respuesta: { "access_token": "...", "token_type": "Bearer", "expires_in": 7200 }.

2. Crear la transacción

curl --location 'https://api-tst.trust.lat/transaction-engine/v1/transactions/' \
  --header 'Authorization: Bearer TU_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "transaction_id": "demo-0001",
    "company_id": "201",
    "authorization_method": "kyc_register",
    "webhook": "https://tu-dominio.cl/webhooks/kyc",
    "metadata": { "country": "CHILE", "nin": "11111111-1", "require_document_validation": true }
  }'

Devuelve data.uuid — el identificador de la transacción.

3. Entregar el link al usuario

https://kyc-tst.trust.lat/transactions/{uuid}

Por correo, botón HTML o QR. El usuario captura documento + selfie con prueba de vida.

4. Consultar el estado

curl --location 'https://api-tst.trust.lat/transaction-engine/v1/transactions/{uuid}' \
  --header 'Authorization: Bearer TU_ACCESS_TOKEN'

Interpreta active / complete / failed:

active	complete	failed	Estado
false	true	false	✅ Exitosa
false	false	true	❌ Fallida
true	false	false	⏳ Pendiente
false	false	false	🕒 Caducada

Siguiente paso

• Detalle de cada parámetro y respuesta: Referencia API.
• Recibir el resultado en tiempo real: Webhooks.
• Personalizar la interfaz: White-label.