En esta página
Prepare la integración KYC con su agente
Elija el lenguaje y copie las instrucciones siguientes en su agente de desarrollo. El contexto incluye las guías públicas, ejemplos completos y la referencia del contrato. Prepare con datos sintéticos; la base de ejemplo .invalid no es un entorno de ejecución.
Prompt y contexto de integración
Instrucciones para su agente
Implemente una integración backend de KYC de Contrato.Cloud en TypeScript / Node.js, utilizando solo la documentación pública indicada abajo.
1. Lea el contexto y OpenAPI antes de escribir código. Cite las páginas utilizadas; pida aclaraciones cuando un campo o comportamiento no esté documentado. No invente una API de firmas SIGN, rutas Admin o endpoints privados del Portal.
2. Use https://api.example.invalid como base sintética. Antes de ejecutar llamadas reales, solicite la base autorizada del entorno y cargue X-API-Key solo desde variables de entorno del backend. Nunca incluya claves en frontend, prompt, URL, logs o repositorio.
3. Cree transacciones con POST /v1/face-auth/transactions e Idempotency-Key estable por operación lógica. Persista transaction_id y external_id. Envíe a la persona a links.webview_url devuelta; no construya la URL de la jornada.
4. Consulte GET /v1/face-auth/transactions/{transaction_id}. Trate status, decision y decision_reason juntos. pending y pasos intermedios siguen pendientes; manual_review_pending espera revisión; approved requiere decision=approved; rejected requiere tratar el rechazo; expired termina o reinicia según la política. Expirar no implica decision=rejected.
5. Preserve los bytes exactos del cuerpo bruto en el receptor de webhooks. Valide X-Face-Auth-Timestamp y X-Face-Auth-Signature (sha256=<hex>) mediante HMAC SHA-256 de timestamp + '.' + raw_body, comparación en tiempo constante y ventana temporal. Solo después interprete JSON y valide el sobre.
6. Deduplicate event_id en almacenamiento duradero, compruebe el identificador del header con el cuerpo y haga idempotentes los efectos de negocio. Reconcilie eventos fuera de orden y entregas perdidas consultando la transacción actual; un evento antiguo no debe degradar una decisión nueva.
7. Entregue configuración, manejo de errores, pruebas con fixtures sintéticas e instrucciones de ejecución. Cubra aprobación, rechazo, pending, expiración, revisión manual, duplicidad, cuerpo alterado, Unicode y timestamp vencido. No ejecute llamadas reales ni procese datos personales sin autorización explícita.
8. cURL cubre solo HTTP. Si se prefiere cURL, use un lenguaje backend soportado para el receptor/HMAC y explique la elección. El MCP siguiente solo consulta documentación pública: no crea transacciones, no firma ni cobra.
Context: https://contrato.cloud/downloads/ai/es/context.md
OpenAPI: https://contrato.cloud/downloads/kyc/openapi.json
Index: https://contrato.cloud/llms.txt
MCP (Streamable HTTP): https://contrato.cloud/api/mcp
MCP prompt: integrate_kyc (locale=es, language=typescript)
MCP tools: search_docs, read_doc, get_example
Revisión del contenido: ab4c5635b7f0f446ba6cfcf3607f9fb94636e233074478aed2ea1a9c23f83ead
Conectar la documentación por MCP
Añada esta URL como servidor MCP remoto en su agente, usando Streamable HTTP. La documentación es pública y no requiere clave ni OAuth.
https://contrato.cloud/api/mcpListe herramientas, recursos y prompts. Use search_docs para buscar guías, read_doc para leer Markdown y get_example para obtener una variante. Seleccione el prompt integrate_kyc con su idioma y lenguaje.
Configuración de ejemplo para clientes compatibles con mcpServers/url
{
"mcpServers": {
"contrato-docs": {
"url": "https://contrato.cloud/api/mcp"
}
}
}Este MCP consulta documentación pública KYC. La ejecución de transacciones y las credenciales pertenecen a su backend.
Valide antes de ejecutar
Revise el código generado, configure la base autorizada en su backend y pruebe idempotencia, HMAC, reconciliación, expiración y revisión manual. Consulte el checklist de producción. La documentación de IA y MCP no reciben claves KYC ni datos de sus clientes.