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
Cinco recursos, cinco 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áginaGuí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áginaEjemplos de Código
Snippets copy-paste en Python, Node.js y cURL para cada flujo común.
Ir a la páginaTutoriales
Guías paso a paso para principiantes: primer request, autenticación y monitoreo.
API Docs
Referencia técnica completa: todos los endpoints, parámetros, esquemas de respuesta y códigos de error.
Abrir docsGuí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/json2. 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 | Available5. 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) Sample event payload your endpoint will receive
{
"SubscriptionId": 1,
"ReferrerId": "your_referrer_id",
"WebhookUrl": "https://yourdomain.com/webhooks/criskco",
"ApiServiceName": "GetApplicants",
"FileType": "JSON",
"DownloadUrlList": null,
"applicantId": "1000143693",
"refApplicantId": "loan-app-00482",
"APIResponse": "{ \"onboardingStatus\": \"Available\", ... }"
}¿Listo para integrar?
Regístrate para obtener tu apiId/apiKey y comienza a consumir datos del SAT en minutos.