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 apps que se sometan al proceso de revisión de apps. Las apps pueden ser propiedad de una organización sin fines de lucro o de un proveedor de tecnología. Para crear una recaudación de fondos para una organización sin fines de lucro mediante la API, la organización debe estar registrada en las herramientas de recaudación de fondos de Meta aquí.

R: La API de recaudación de fondos está disponible en los países en los que las organizaciones sin fines de lucro pueden solicitar acceso a 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 en Facebook son públicas, pero es posible crear una recaudación de fondos de prueba que solo puedan ver los desarrolladores de tu app. Para ello, puedes crear una recaudación de fondos con el modo "En desarrollo" de la app. Las recaudaciones de fondos creadas de esta manera mostrarán un banner en la parte superior que indica que solo los desarrolladores de la app pueden ver la recaudación de fondos. Cuando cambies la app de modo "En desarrollo" a "Activo", las recaudaciones de fondos de prueba seguirán ocultas para el público general. Las recaudaciones de fondos creadas por una app en modo "Activo" seguirán siendo públicas, incluso si la app vuelve a estar "En desarrollo".

R: El token de acceso de usuario de la solicitud debe pertenecer a un usuario real de Facebook. Puedes usar una app en modo "En desarrollo" para crear recaudaciones de fondos de prueba que no se muestren al público general.

R: Las recaudaciones de fondos creadas con una app activa estarán activas y visibles públicamente, mientras que las recaudaciones de fondos creadas con una app en desarrollo solo estarán visibles para los desarrolladores y administradores de la app. Las recaudaciones de fondos en modo activo y en desarrollo pueden recibir donaciones, pero los webhooks solo se envían cuando la app está activa.

R: Por el momento, no admitimos donaciones de prueba, por lo que todas las donaciones deben realizarse con una credencial de pago válida. El importe mínimo que puedes donar es de 5 USD. Puedes solicitar un reembolso mediante el formulario de contacto que figura en esta página.

R: Las apps en modo de desarrollo no reciben un evento de webhook cuando se hace una donación, lo que dificulta la creación de una prueba de extremo a extremo. Por este motivo, tienes 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 app que esté "En desarrollo" (para que la recaudación de fondos no sea pública) y, luego, cambiar la app a modo "Activo" a fin de que se puedan recibir webhooks cuando hagas una donación.

Acciones del participante

R: Si bien no es habitual, las personas pueden eliminar sus recaudaciones de fondos en Facebook. Cuando esto sucede, cualquier llamada a la API Graph que haga referencia a la recaudación de fondos devolverá un error. Como no hay un webhook que te informe en tiempo real que se eliminó una recaudación de fondos, puedes controlar 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 considerarla una acción definitiva. En este punto, es posible que quieras ofrecer a la persona 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 en Facebook comenzará de cero y no reflejará ninguna donación anterior. Para contabilizar las donaciones anteriores, debes publicar como donaciones externas todas las que se hayan recibido hasta el momento, incluidas las que se hayan recibido anteriormente en Facebook. De esta manera, te aseguras de que el monto 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. En el caso de 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 en Facebook

R: Admitimos donaciones de una lista específica de países. Puedes encontrar una lista completa de países aquí: https://facebook.com/help/837523116348786. Las personas que no puedan donar verán el botón "Donar" desactivado.

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

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

R: El webhook no contiene información del donante, pero incluye un identificador de pago que puedes usar para buscar el identificador correspondiente en los informes de transacciones.

Reembolsos de donaciones

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

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