Primeros pasos

Modo de prueba

Construye y prueba una integración sin datos personales reales: las API keys de prueba responden cada consulta con personas, empresas y documentos ficticios, nunca llegan a un registro y nunca se cobran.

Una API key de prueba llama a las mismas URLs que una real y recibe respuestas con la misma forma, de personas, empresas y documentos ficticios. Úsala para construir y probar tu integración, en desarrollo y en CI, sin enviar datos reales de nadie.

Obtén una key de prueba

En el panel, abre API Keys, marca "Key de prueba" y créala. Una key de prueba empieza con rfc_test_ y va en el mismo encabezado x-api-key. Un asistente de IA conectado por el servidor MCP puede crear una con create_api_key y test: true.

Solicitud con una key de prueba bash
curl -X POST https://mexcheck.com/v1/rfc/validate \
  -H "x-api-key: rfc_test_your_test_key" \
  -H "Content-Type: application/json" \
  -d '{"rfc": "PUDJ800101AA1"}'

Qué hace una key de prueba

  • Nunca llega al SAT, RENAPO, INE ni CFE, y nunca se cobra: no necesita plan ni saldo, y sus solicitudes no cuentan en tu uso.
  • Cada respuesta lleva el encabezado x-test-mode: true.
  • La entrada se revisa con las mismas reglas del endpoint real, así que una solicitud mal formada recibe el mismo 422 que recibiría en producción.
  • Los identificadores de prueba de abajo devuelven sus registros ficticios. Cualquier otro identificador bien formado devuelve la respuesta de "no encontrado" del endpoint, y un identificador por registro responde como si el registro estuviera caído (found o valid null), para probar tus reintentos.
  • Un webhook_url recibe la respuesta de prueba como un POST, igual que en producción: primero 202 y luego el resultado.
  • Un archivo enviado a /v1/csf/verify o /v1/cfe/verify no se lee: cualquier archivo responde como la constancia o el recibo de muestra.
  • Los endpoints de códigos postales (/v1/geo/zip, /v1/geo/zip-search) leen datos públicos, así que responden con el catálogo real, sin costo.
  • El Registro Público de Comercio y los endpoints de lectura de credencial, prueba de vida y sesiones del INE aún no tienen modo de prueba: responden 403 con el error test_mode_unsupported.

Los RFC de prueba llevan un dígito verificador incorrecto, así que ninguno puede pertenecer a un contribuyente real. Ninguno de estos registros describe a una persona o empresa real.

RFC

Para /v1/rfc/validate, /profile, /find-zip, /verify, /sat-lists y /verify-batch.

RFC Respuesta
PUDJ800101AA1 Persona física registrada JUAN PRUEBA DEMO, código postal 06600, CURP PUDJ800101HDFRMN06, con certificados.
EDE100101AA1 Persona moral registrada EMPRESA DEMO SA DE CV, código postal 06600; su representante legal es JUAN PRUEBA DEMO.
ELI100101AA1 Persona moral registrada EMPRESA LISTADA SA DE CV, código postal 64000, en la lista 69-B del SAT.
NODI000101AA1 No se pudo consultar al SAT: valid o found es null.
XAXX010101000, XEXX010101000 Los RFC genéricos del SAT, respondidos como en producción.
Cualquier otro No registrado: valid o found es false.

/find-zip, /verify y /verify-batch también revisan el nombre y el código postal: envía el nombre registrado (el de una empresa, con o sin SA DE CV) y su código postal para obtener una coincidencia, y cualquier otro para obtener una discrepancia. Con include_curp: true, /validate agrega la identidad verificada de la persona o del representante legal.

CURP

Solicitud Respuesta
/v1/curp/lookup PUDJ800101HDFRMN06 JUAN PRUEBA DEMO, nacido el 1980-01-01. Con include_pdf: true, un PDF de muestra.
/v1/curp/lookup NODI000101HDFDSPA7 No se pudo consultar a RENAPO: found es null.
/v1/curp/search names JUAN, paternal_surname PRUEBA, mothers_maiden_name DEMO, birthdate 1980-01-01, sex H, state DF encuentran PUDJ800101HDFRMN06.
Cualquier otro Sin registro: found es false.

Credencial para votar (INE)

Para /v1/ine/verify, por CIC, con cualquier id_ciudadano u ocr.

CIC Respuesta
000000001 Credencial vigente (vigente).
000000002 Una credencial que ya no es válida (no_vigente).
000000003 No se pudo consultar al INE: found es null.
Cualquier otro Sin registro (no_encontrada).

CFDI

Para /v1/cfdi/verify, por folio fiscal (uuid), con cualquier rfc_emisor y rfc_receptor, o dentro de un XML subido.

Folio fiscal Respuesta
00000000-0000-0000-0000-000000000001 Vigente (vigente).
00000000-0000-0000-0000-000000000002 Cancelado (cancelado).
00000000-0000-0000-0000-000000000003 No se pudo consultar al SAT: found es null.
Cualquier otro No registrado (no_encontrado).

Constancia de Situación Fiscal

Solicitud Respuesta
rfc EDE100101AA1, id_cif 10000000001 El registro del SAT de EMPRESA DEMO SA DE CV.
rfc PUDJ800101AA1, id_cif 10000000002 El registro del SAT de JUAN PRUEBA DEMO.
rfc NODI000101AA1 No se pudo consultar al SAT: found es null.
Cualquier archivo Una constancia que el SAT emitió y que coincide con su registro (document.issuance verified, alert null).
Cualquier otro No emitida: found es false.

Recibo de CFE

Solicitud Respuesta
service_number 100000000001, name JUAN PRUEBA DEMO, total 500 CFE confirma el servicio.
El mismo servicio con otro nombre o total found false, mismatch name o total.
service_number 100000000003 No se pudo consultar a CFE: found es null.
Cualquier archivo Un recibo que CFE emitió y que coincide con su copia (document.matches_cfe true).
Cualquier otro número de servicio found false, mismatch null.

Pasar a producción

Cambia la key de prueba por una real. Nada más cambia: mismas URLs, mismos campos. Las respuestas reales no llevan el encabezado x-test-mode.