Llave y ambientes

Dónde está tu llave

1. Entra a tu cuenta del ambiente que vas a usar: sandbox-app.facturadigital.com.mx para pruebas o app.facturadigital.com.mx para producción.
2. Ve a Configuración › API y desarrolladores.
3. Copia la Llave vigente tal como aparece. Ya viene en el formato que espera el encabezado.

Esa pantalla también muestra la Llave anterior, el formato que usaban las integraciones viejas. Funciona hasta el 30 de junio de 2027; mientras la uses, cada respuesta trae el encabezado X-FD-ApiKey-Deprecation con la fecha de corte. Cambia tu integración a la llave vigente antes de esa fecha.

Cómo se manda

En el encabezado X-Api-Key de cada petición. No hay que firmar nada ni pedir un token antes. Las peticiones POST mandan su cuerpo como formulario (application/x-www-form-urlencoded), salvo stampxmlfile, que manda un archivo.

curl -sS "https://sandbox-app.facturadigital.com.mx/api/v5/account/balance" \
  -H "X-Api-Key: $FD_API_KEY"

const res = await fetch("https://sandbox-app.facturadigital.com.mx/api/v5/account/balance", {
  headers: { "X-Api-Key": process.env.FD_API_KEY },
});

$ch = curl_init('https://sandbox-app.facturadigital.com.mx/api/v5/account/balance');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Api-Key: ' . getenv('FD_API_KEY')]);

requests.get("https://sandbox-app.facturadigital.com.mx/api/v5/account/balance",
             headers={"X-Api-Key": os.environ["FD_API_KEY"]})

Sandbox y producción

Son dos cuentas aparte, con datos, folios y llaves propias. Lo que hagas en sandbox no toca tus CFDI de producción. Para pasar a producción cambias la URL base y la llave; el código es el mismo.

Si la llave no funciona

Todos estos casos responden HTTP 400 con code 501. El final del mensaje dice qué ambiente te respondió, por ejemplo [Environment: SANDBOX].

Tu saldo de folios

Responde los folios disponibles de la cuenta de la llave. Es la petición más simple para comprobar que la llave y la URL son del mismo ambiente.

{
  "message": "10 credits available.",
  "balance": 10,
  "code": 200
}

Obtener la llave por API

Si tu sistema necesita leer la llave sin entrar a la pantalla, account/authorize la regresa a cambio del usuario y la contraseña de la plataforma, en los encabezados API-USUARIO y API-PASSWORD. Úsalo solo desde tu servidor y por HTTPS: viaja la contraseña.

Con un usuario o contraseña incorrectos responde HTTP 401 con code 502. Después de varios intentos fallidos desde la misma IP responde HTTP 403 con code 503 hasta que pase el bloqueo.