API de recaudación de fondos - Preguntas frecuentes

Disponibilidad

R: La API de recaudación de fondos es pública y está disponible para las aplicaciones que se sometan al proceso de revisión de aplicaciones. Las aplicaciones pueden ser propiedad de una organización sin ánimo de lucro o de un proveedor de tecnología. Para poder crear una recaudación de fondos para una organización sin ánimo de lucro mediante la API, la organización debe haber realizado la incorporación a las herramientas de recaudación de fondos de Meta aquí.

R: La API de recaudación de fondos está disponible en países en los que las organizaciones sin ánimo de lucro pueden solicitar las herramientas de recaudación de fondos. Puedes consultar la lista de países admitidos aquí: https://facebook.com/help/1251484118194936.

Consulta esta página para obtener instrucciones sobre cómo acceder a la API.

Pruebas

R: Todas las recaudaciones de fondos de Facebook son públicas, pero es posible crear una recaudación de fondos de prueba que solo puedan ver los desarrolladores de tu aplicación. Para ello, solo tienes que crear una recaudación de fondos con el modo “En desarrollo” de la aplicación. Las recaudaciones de fondos creadas de esta forma mostrarán un banner en la parte superior que indica que solo los desarrolladores de la aplicación pueden ver la recaudación. Al cambiar el estado de "En desarrollo" a "Publicada", las recaudaciones de fondos de prueba seguirán ocultas para el público general. Las recaudaciones de fondos creadas por una aplicación “Publicada” seguirán siendo públicas, aunque la aplicación vuelva a estar “En desarrollo”.

R: El identificador de acceso de usuario de la solicitud debe pertenecer a un usuario real de Facebook. Puedes usar el modo “En desarrollo” de una aplicación para crear recaudaciones de fondos de prueba que no se muestren al público general.

R: Las recaudaciones de fondos creadas con una aplicación publicada estarán activas y serán públicas, mientras que las que se creen con una aplicación en desarrollo solo serán visibles para los desarrolladores y administradores de la aplicación. Las recaudaciones de fondos en desarrollo y publicadas pueden recibir donaciones, pero los webhooks solo se envían cuando la aplicación está publicada.

R: En estos momentos no admitimos donaciones de prueba, por lo que todas las donaciones deben realizarse con credenciales de pago válidas. La cantidad mínima que puedes donar es de 5 USD. Puedes solicitar un reembolso mediante el formulario de contacto que aparece en esta página.

R: Las aplicaciones en desarrollo no reciben un evento de webhook cuando se hace una donación, lo que dificulta la creación de una prueba integral. Por este motivo, dispones de dos opciones para probar el webhook: puedes activar manualmente un evento de webhook desde el panel para desarrolladores o puedes crear una recaudación de fondos con una aplicación que se encuentre “En desarrollo” (para que la recaudación de fondos no sea pública) y, a continuación, cambiar la aplicación a “Publicada” para que se puedan recibir webhooks cuando hagas una donación.

Acciones del participante

R: Aunque no es habitual, las personas pueden eliminar sus recaudaciones de fondos en Facebook. Si esto sucede, cualquier llamada a la API Graph que haga referencia a la recaudación de fondos dará error. Como no hay ningún webhook que te informe de que una recaudación de fondos se ha eliminado en tiempo real, puedes gestionar la eliminación cuando recibas un error al intentar leer la recaudación de fondos o publicar una nueva donación externa. La eliminación de una recaudación de fondos no se puede deshacer, por lo que debes saber que es una acción definitiva. En este punto, puede que quieras ofrecerle una forma de volver a conectarse a Facebook en tu centro de participantes para crear una nueva recaudación de fondos en Facebook.

R: La nueva recaudación de fondos de Facebook empezará de cero y no reflejará ninguna donación anterior. Para contabilizar las donaciones anteriores, debes publicar como donaciones externas todas las donaciones que se hayan recibido hasta el momento, incluidas las que se hayan recibido anteriormente en Facebook. De esta forma, te aseguras de que el importe total recaudado coincida con el que se muestra en tu sitio.

R: Puedes decidir si quieres finalizar la recaudación de fondos de Facebook en estos casos. Para las transferencias de participantes, puedes actualizar la fecha de finalización mediante la API para garantizar que la recaudación de fondos de Facebook finalice según la nueva fecha del evento.

Donaciones de Facebook

R: Admitimos donaciones de una lista específica de países. Puedes consultar la lista completa de países aquí: https://facebook.com/help/837523116348786. Las personas que no puedan donar verán el botón "Hacer donación" de color gris.

R: Podría haber un problema con la tarjeta que el donante está intentando utilizar. Intenta eliminar la tarjeta y volver a añadirla desde la configuración de pagos: https://secure.facebook.com/settings?tab=payments&section=settings.

R: Puedes descargar informes de transacciones desde la página de la organización. Obtén más información aquí: https://facebook.com/help/1787615158233986.

R: El webhook no contiene información del donante, pero incluye un identificador del pago que puedes relacionar con los identificadores que aparecen en los informes de transacciones.

Reembolsos de donaciones

R: Actualmente, cuando se reembolsa una donación, la recaudación de fondos de Facebook no refleja dicho reembolso y el importe total recaudado permanece invariable. No se activará ningún evento de webhook para notificarte el reembolso.

R: Si alguien hace una donación en tu sitio y, más tarde, solicita un reembolso, debes mantener el importe de la donación sincronizado con Facebook. Para obtener reembolsos totales, puedes eliminar la donación externa que publicaste anteriormente. Para los reembolsos parciales, puedes eliminar la donación externa y publicar una nueva con el importe actualizado.