---
title: Mi integración de API falla, ¿qué reviso antes de contactar a soporte?
description: Qué revisar si falla una solicitud a la API de Mifiel o no recibes una notificación por webhook, y qué información compartir con soporte.
---

[Ir directamente al contenido](https://guia.mifiel.com/es/mi-integración-de-api-falla-qué-reviso-antes-de-contactar-a-soporte#main-content)

Español

Traducciones de Mostrar submenú de

[![Logo de Mifiel](https://guia.mifiel.com/hubfs/logo.svg)](https://www.mifiel.com/es/)

- [Preguntas frecuentes](https://guia.mifiel.com/)

Abrir navegación principal

Cerrar navegación principal

- [Preguntas frecuentes](https://guia.mifiel.com/)
- Español
  
  Traducciones de Mostrar submenú de

 Hola, ¿cómo podemos ayudarte?

- No hay sugerencias porque el campo de búsqueda está vacío.

1. [Preguntas Frecuentes](https://guia.mifiel.com/es?hsLang=es)
2. [Integración API](https://guia.mifiel.com/es/integraci%C3%B3n-api?hsLang=es)

# Mi integración de API falla, ¿qué reviso antes de contactar a soporte?

Si una solicitud a la API de Mifiel falla, revisa el mensaje de error y estas posibles causas antes de volver a intentarlo:

- Ambiente: confirma que estás enviando la solicitud al ambiente correcto: sandbox para pruebas o producción para operaciones reales. Usa las credenciales correspondientes a ese ambiente.
- Créditos: revisa que la cuenta tenga los créditos necesarios para la operación que intentas realizar.
- Funcionalidad: confirma que la función que estás utilizando esté habilitada para tu cuenta.
- Solicitud: compara los campos y el formato que estás enviando con lo que indica la documentación de ese endpoint.

Un código de error por sí solo no siempre permite identificar la causa. Si el problema continúa, comparte con soporte:

- El ambiente en el que ocurre: sandbox o producción.
- El método y la ruta del endpoint utilizado.
- El código HTTP y el mensaje de error completo, ocultando datos personales o secretos.
- La fecha y hora de la solicitud, con su zona horaria.
- Una descripción de lo que intentabas hacer.

No compartas tokens, contraseñas ni encabezados de autorización. Si envías un ejemplo de la solicitud, sustituye las credenciales y los datos personales por valores ficticios.

## Si no recibes una notificación por webhook

Una solicitud a la API puede completarse correctamente aunque tu sistema no reciba o no procese la notificación correspondiente.

- Confirma que el webhook esté configurado en el ambiente correcto y que la URL receptora sea la esperada.
- Revisa que estés esperando el evento correcto: la firma de un participante y el cierre del documento son eventos distintos.
- Consulta los registros de tu servidor para distinguir si la notificación no llegó o si llegó, pero tu sistema no pudo procesarla. Revisa también qué respuesta HTTP devolvió.

Si necesitas ayuda de soporte, comparte el ID del documento, el evento esperado, el ambiente y la fecha y hora del problema con zona horaria. Incluye los registros disponibles, ocultando credenciales y datos sensibles.

- [Firma de documentos](https://guia.mifiel.com/es/firma-de-documentos?hsLang=es#main-content)

    - [Cómo firmar un documento usando la e.firma en Mifiel](https://guia.mifiel.com/es/firma-de-documentos?hsLang=es#c%C3%B3mo-firmar-un-documento-usando-la-e-firma-en-mifiel)
    - [Características de la e.firma](https://guia.mifiel.com/es/firma-de-documentos?hsLang=es#caracter%C3%ADsticas-de-la-e-firma)
    - [Errores comunes](https://guia.mifiel.com/es/firma-de-documentos?hsLang=es#errores-comunes)
- [Preparación de documentos](https://guia.mifiel.com/es/preparaci%C3%B3n-de-documentos?hsLang=es#main-content)

    - [Invitar firmantes](https://guia.mifiel.com/es/preparaci%C3%B3n-de-documentos?hsLang=es#invitar-firmantes)
    - [Personalizar características de un documento](https://guia.mifiel.com/es/preparaci%C3%B3n-de-documentos?hsLang=es#personalizar-caracter%C3%ADsticas-de-un-documento)
- [Gestión de documentos](https://guia.mifiel.com/es/gesti%C3%B3n-de-documentos?hsLang=es#main-content)

    - [General](https://guia.mifiel.com/es/gesti%C3%B3n-de-documentos?hsLang=es#general)
    - [Para administradores de documentos](https://guia.mifiel.com/es/gesti%C3%B3n-de-documentos?hsLang=es#para-administradores-de-documentos)
- [Verificación de un documento firmado y sus firmas](https://guia.mifiel.com/es/verificaci%C3%B3n-de-un-documento-firmado-y-sus-firmas?hsLang=es)
- [Proceso de firma privado de documentos encriptados](https://guia.mifiel.com/es/proceso-de-firma-privado-de-documentos-encriptados?hsLang=es#main-content)

    - [Creación de documentos encriptados](https://guia.mifiel.com/es/proceso-de-firma-privado-de-documentos-encriptados?hsLang=es#creaci%C3%B3n-de-documentos-encriptados)
    - [Firma de documentos encriptados](https://guia.mifiel.com/es/proceso-de-firma-privado-de-documentos-encriptados?hsLang=es#firma-de-documentos-encriptados)
    - [Configuración de organizaciones y cuentas](https://guia.mifiel.com/es/proceso-de-firma-privado-de-documentos-encriptados?hsLang=es#configuraci%C3%B3n-de-organizaciones-y-cuentas)
- [Integración API](https://guia.mifiel.com/es/integraci%C3%B3n-api?hsLang=es#main-content)

    - [General](https://guia.mifiel.com/es/integraci%C3%B3n-api?hsLang=es#general)
    - [Personalizaciones en el widget de firma](https://guia.mifiel.com/es/integraci%C3%B3n-api?hsLang=es#personalizaciones-en-el-widget-de-firma)
    - [Funciones adicionales](https://guia.mifiel.com/es/integraci%C3%B3n-api?hsLang=es#funciones-adicionales)
- [Planes y paquetes, facturación y pago](https://guia.mifiel.com/es/planes-y-paquetes-facturaci%C3%B3n-y-pago?hsLang=es#main-content)

    - [Funcionalidades](https://guia.mifiel.com/es/planes-y-paquetes-facturaci%C3%B3n-y-pago?hsLang=es#funcionalidades)
    - [Esquema de precios](https://guia.mifiel.com/es/planes-y-paquetes-facturaci%C3%B3n-y-pago?hsLang=es#esquema-de-precios)
    - [Proceso de compra](https://guia.mifiel.com/es/planes-y-paquetes-facturaci%C3%B3n-y-pago?hsLang=es#proceso-de-compra)
    - [Proceso de facturación](https://guia.mifiel.com/es/planes-y-paquetes-facturaci%C3%B3n-y-pago?hsLang=es#proceso-de-facturaci%C3%B3n)
    - [Consulta de consumos](https://guia.mifiel.com/es/planes-y-paquetes-facturaci%C3%B3n-y-pago?hsLang=es#consulta-de-consumos)
    - [Errores frecuentes](https://guia.mifiel.com/es/planes-y-paquetes-facturaci%C3%B3n-y-pago?hsLang=es#errores-frecuentes)
- [Manejo de tu cuenta y tu e.firma](https://guia.mifiel.com/es/manejo-de-tu-cuenta-y-tu-e-firma?hsLang=es#main-content)

    - [Tu cuenta de Mifiel](https://guia.mifiel.com/es/manejo-de-tu-cuenta-y-tu-e-firma?hsLang=es#tu-cuenta-de-mifiel)
    - [Funcionalidades para firmantes](https://guia.mifiel.com/es/manejo-de-tu-cuenta-y-tu-e-firma?hsLang=es#funcionalidades-para-firmantes)
    - [Tu e.firma (FIEL)](https://guia.mifiel.com/es/manejo-de-tu-cuenta-y-tu-e-firma?hsLang=es#tu-e-firma-fiel)
- [Temas legales](https://guia.mifiel.com/es/temas-legales?hsLang=es#main-content)

    - [Normatividad de la firma electrónica](https://guia.mifiel.com/es/temas-legales?hsLang=es#normatividad-de-la-firma-electr%C3%B3nica)
    - [Dudas al transicionar a la firma electrónica](https://guia.mifiel.com/es/temas-legales?hsLang=es#dudas-al-transicionar-a-la-firma-electr%C3%B3nica)
    - [Otras dudas legales](https://guia.mifiel.com/es/temas-legales?hsLang=es#otras-dudas-legales)
- [Gestión de Organizaciones](https://guia.mifiel.com/es/gesti%C3%B3n-de-organizaciones?hsLang=es#main-content)

    - [Generar una organización en Mifiel](https://guia.mifiel.com/es/gesti%C3%B3n-de-organizaciones?hsLang=es#generar-una-organizaci%C3%B3n-en-mifiel)
    - [Agregar miembros y editar sus permisos](https://guia.mifiel.com/es/gesti%C3%B3n-de-organizaciones?hsLang=es#agregar-miembros-y-editar-sus-permisos)
- [Acerca de Mifiel](https://guia.mifiel.com/es/acerca-de-mifiel?hsLang=es#main-content)

    - [Información general](https://guia.mifiel.com/es/acerca-de-mifiel?hsLang=es#informaci%C3%B3n-general)
- [Firmando desde la app móvil](https://guia.mifiel.com/es/firmando-desde-la-app-m%C3%B3vil?hsLang=es)
- [Noticias](https://guia.mifiel.com/es/noticias?hsLang=es)
- [Portal de Fondeo Estructurado](https://guia.mifiel.com/es/portal-de-fondeo-estructurado?hsLang=es)

[![Chill listening crop-3](https://guia.mifiel.com/hs-fs/hubfs/logo-only-1.png?width=24&height=24&name=logo-only-1.png "Chill listening crop-3")](https://www.mifiel.com/es)

 

Copyright © 2025, Mifiel

```json
{
  "@context" : "https://schema.org",
  "@type" : "Organization",
  "logo" : "https://app.mifiel.com/assets/mifiel_branding.png",
  "name" : "Mifiel",
  "sameAs" : [ "https://www.linkedin.com/company/mifiel", "https://www.facebook.com/mifielfirma", "https://x.com/mifielfirma", "https://www.youtube.com/channel/UCd1tLtxCHH2Qv-iAOLEXyGA" ],
  "url" : "https://www.mifiel.com/es/"
}
```

```json
{
  "@context" : "https://schema.org",
  "@type" : "WebSite",
  "name" : "Preguntas Frecuentes de Mifiel",
  "potentialAction" : {
    "@type" : "SearchAction",
    "query-input" : "required name=search_term_string",
    "target" : {
      "@type" : "EntryPoint",
      "urlTemplate" : "https://guia.mifiel.com/search?q={search_term_string}"
    }
  },
  "url" : "https://guia.mifiel.com/"
}
```