QAPI está en beta — la API puede cambiar sin previo aviso. Usá sandbox para pruebas.
QAPIQAPIDocs · by DTEVIA
Errores

SSRF_BLOCKED (400)

La URL del webhook no es HTTPS o apunta a una dirección privada o interna.

HTTP 400 Bad Request

El webhook_url del body de POST /v1/invoices (o de POST /v1/sandbox/invoices) cae en uno de estos casos, y la factura no se emite:

  • No es HTTPS.
  • Apunta a una IP privada o reservada (por ejemplo 10.x.x.x, 192.168.x.x o 127.0.0.1, y sus equivalentes IPv6).
  • Usa un nombre de host local o interno, como localhost.
  • Su dominio resuelve a una IP privada o reservada.

También responde así al guardar en el dashboard el webhook de la cuenta o de un proyecto con una dirección privada o interna.

Ejemplo

{
  "type": "https://docs.dtevia.com.gt/errors/ssrf-blocked",
  "title": "SSRF_BLOCKED",
  "status": 400,
  "detail": "La URL del webhook apunta a una dirección IP privada o reservada"
}

Cómo resolverlo

  • Usá una URL HTTPS pública, cuyo dominio resuelva a una IP pública.
  • Para probar en local, exponé tu endpoint con un túnel HTTPS (ngrok, Cloudflare Tunnel) en vez de localhost o una IP de tu red.

Otro puerto o credenciales en la URL

Una URL en otro puerto que el 443, o con usuario y contraseña, responde VALIDATION_ERROR (422), no este error.

Ver Webhooks.

En esta página