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.
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.