📘 2025 Report:Mexico Economic Review 2025 — outlook, charts, and sector signalsRead

    Tutoriales de Integración API

    Cinco pasos verificados contra la documentación oficial: credenciales, primera llamada, onboarding SAT con CIEC, polling y webhooks.

    Recursos para desarrolladores

    Seis recursos, seis propósitos. Elija el que coincida con dónde está en su integración.

    SAT Integration Hub

    Empieza aquí: qué expone la API del SAT, cómo CRiskCo abstrae SOAP/CIEC, y FAQ técnico.

    Ir a la página

    Guía de Integración API

    Walkthrough end-to-end: autenticación, modelos de integración (Approve / White-label / Webhook) y catálogo completo de endpoints.

    Ir a la página

    Ejemplos de Código

    Snippets copy-paste en Python, Node.js y cURL para cada flujo común.

    Ir a la página
    Estás aquí

    Tutoriales

    Guías paso a paso para principiantes: primer request, autenticación y monitoreo.

    Explorador de API

    Cada endpoint y cada campo en una sola vista buscable. Pensado para equipos evaluando o migrando su integración.

    Ir a la página

    API Docs

    Referencia técnica completa: todos los endpoints, parámetros, esquemas de respuesta y códigos de error.

    Abrir docs

    Guías Paso a Paso

    1. Obtén tus credenciales (apiId + apiKey)

    Regístrate en CRiskCo para recibir tu apiId y apiKey por correo. Ambos viajan como headers en cada petición — no hay flujo OAuth ni tokens Bearer. Las llaves de prueba devuelven datos sandbox sin costo.

    # Required headers on every API call
apiId: YOUR_API_ID
apiKey: YOUR_API_KEY
Content-Type: application/json

    2. Tu primera llamada autenticada

    Verifica que tus credenciales funcionan llamando GET /get-applicants. La base URL para todas las llamadas es https://service.criskco.com/apiservice.svc.

    curl -G "https://service.criskco.com/apiservice.svc/get-applicants" \
  -H "apiId: YOUR_API_ID" \
  -H "apiKey: YOUR_API_KEY" \
  -H "Content-Type: application/json"

    3. Onboard de un aplicante con CIEC

    El onboarding al SAT se hace con la contraseña CIEC del contribuyente (CRiskCo no requiere e.firma). Envía RFC y CIEC al endpoint OnboardingSatIntegration.

    POST https://service.criskco.com/apiservice.svc/OnboardingSatIntegration
Headers: apiId, apiKey, Content-Type: application/json

{
  "IsAgreeTerms": true,
  "DateAgreeTerms": "2026-04-16",
  "VersionAgreeTerms": "1",
  "Email": "contact@empresa.com",
  "User": "GAPXXXXXXXXX",
  "Password": "CIEC_PASSWORD",
  "RefApplicantId": "loan-app-00482"
}

    4. Polling del estado del onboarding

    Después del onboarding, consulta GET /get-applicants cada 5–10 segundos hasta que onboardingStatus sea 'Available'. Valores posibles: NotConnected, Processing, Available.

    curl -G "https://service.criskco.com/apiservice.svc/get-applicants" \
  -H "apiId: YOUR_API_ID" \
  -H "apiKey: YOUR_API_KEY" \
  --data-urlencode "taxId=GAPXXXXXXXXX" \
  --data-urlencode "onboardingStatus=true"

# Response includes onboardingStatus: NotConnected | Processing | Available

    5. Suscríbete a webhooks

    Registra una CallbackUrl con POST /Subscriptions. CRiskCo enviará primero un GET de validación a tu URL — tu servidor debe responder HTTP 200 en menos de 2 segundos. Después recibirás eventos con FileType: 'JSON' (payload inline en APIResponse) o 'JSON_LINK' (URL de descarga en DownloadUrlList).

    # 1) Register the webhook
POST https://service.criskco.com/apiservice.svc/Subscriptions
Headers: apiId, apiKey, Content-Type: application/json
{ "CallbackUrl": "https://yourdomain.com/webhooks/criskco" }

# 2) CRiskCo then sends a GET to that URL for validation —
#    respond HTTP 200 within 2 seconds.

# 3) Events arrive as POSTs with FileType="JSON" (inline payload)
#    or FileType="JSON_LINK" (signed download URLs).
#    For the exact event payload schema, see api-docs.criskco.com.

    ¿Listo para integrar?

    Regístrate para obtener tu apiId/apiKey y comienza a consumir más de 30 endpoints SAT en minutos.

    Explorar Más