Esta guía te lleva de cero a tu primer RFC validado. Las cuentas nuevas reciben un crédito de $5 USD al registrarse, así que puedes llamar al API de inmediato.
1. Crea una cuenta
Regístrate y confirma tu correo. Tu crédito de $5 USD aparece en tu panel.
2. Genera una llave API
Desde el panel, abre Llaves API y crea una nueva llave. Las llaves se muestran una sola vez, así que copia la tuya a tu gestor de secretos antes de salir de la página.
3. Haz tu primera llamada
El endpoint verify es la llamada más barata, a 1 crédito, y la más rápida de inspeccionar. Vamos a usar un RFC de prueba conocido.
curl -X POST https://rfccheck.com/v1/rfc/verify \
-H "x-api-key: rfc_your_api_key" \
-H "Content-Type: application/json" \
-d '{"rfc": "XAXX010101000"}'Deberías recibir algo como:
{
"rfc": "XAXX010101000",
"valid": true,
"message": "RFC válido, y susceptible de recibir facturas"
}4. Elige el endpoint correcto
Cada endpoint responde a una pregunta distinta. Los endpoints más baratos y acotados son más rápidos, así que usa el más pequeño que responda tu pregunta.
| Si quieres… | Usa | Costo |
|---|---|---|
| "¿Este RFC está registrado en el SAT?" | /rfc/verify |
1 credit |
| "¿Cuál es el nombre, CURP y correo de contacto de este RFC?" | /rfc/profile |
3 credits |
| "¿Cuál es el código postal para este RFC + nombre?" | /rfc/find-zip |
5 credits |
| "Dame todo lo que tengas sobre este RFC." | /rfc/validate |
10 credits |
| "Verifica 5,000 registros a la vez." | /rfc/verify-batch |
1 crédito × N |
5. Maneja los errores
El API usa códigos de estado HTTP estándar. Ver Errores para ver la lista completa.