API Fundraiser - Questions/réponses

Disponibilité

R : L’API Fundraiser est publique et disponible pour les applications ayant passé le Contrôle app. Les applications peuvent appartenir à une organisation à but non lucratif ou à un fournisseur de technologies. Pour pouvoir créer une collecte de dons pour une organisation à but non lucratif via l’API, cette organisation doit s’inscrire aux outils de collecte de dons de Meta ici.

R : L’API Fundraiser est disponible dans les pays où les organisations à but non lucratif peuvent s’inscrire aux outils de collecte de dons. Vous trouverez une liste des pays pris en charge ici : https://facebook.com/help/1251484118194936.

Consultez cette page pour obtenir des instructions sur la demande d’accès à l’API.

Tests

R : Sur Facebook, toutes les collectes de dons sont publiques, mais il est possible de créer une collecte de dons de test uniquement visible pour l’équipe de développement de votre application. Pour cela, vous pouvez tout simplement créer une collecte de dons en utilisant une application en mode développement. Une bannière indiquant que la collecte de dons est uniquement visible pour l’équipe de développement de l’application s’affichera en haut des collectes de dons créées de cette manière. Lorsque votre application passera du mode développement au mode live, vos collectes de dons de test resteront invisibles pour le grand public. Les collectes de dons créées par une application en mode live resteront publiques, même si l’application retourne en mode développement.

R : Le token d’accès utilisateur associé à la demande doit correspondre à un vrai compte Facebook. Vous pouvez utiliser une application en mode développement pour créer des collectes de dons de test invisibles pour le grand public.

R : Les collectes de dons créées à l’aide d’une application en mode live seront en ligne et publiques, tandis que les collectes de dons créées via une application en mode développement seront uniquement visibles pour l’équipe de développement et les admins de l’application. Les collectes de dons peuvent recevoir des contributions à la fois en mode live et en mode développement, mais les webhooks sont uniquement envoyés lorsque l’application est en mode live.

R : Pour le moment, nous ne prenons pas en charge les dons de test, et tous les dons doivent être effectués via un moyen de paiement valide. Le montant minimum que vous pouvez donner est de 5 $, et vous pouvez demander un remboursement à l’aide du formulaire de contact que vous trouverez sur cette page.

R : Les applications en mode développement ne reçoivent pas d’évènement webhook lorsqu’un don est effectué, ce qui complique la création d’un test de bout en bout. Vous disposez de deux options pour tester le webhook : vous pouvez soit déclencher un évènement webhook manuellement à partir de votre tableau de bord développeur·se, soit créer une collecte de dons à l’aide d’une application en mode développement (pour que la collecte de dons ne soit pas publique) puis passer en mode live pour que les webhooks puissent être reçus lorsque vous effectuez un don.

Actions des participant·es

R : Bien que cela ne soit pas courant, les collectes de dons peuvent être supprimées de Facebook. Lorsque cela arrive, tout appel de l’API Graph mentionnant cette collecte de dons renverra une erreur. Étant donné qu’il n’y a pas de webhook pour vous indiquer qu’une collecte de dons a été supprimée en temps réel, vous pouvez gérer la suppression lorsque vous recevez une erreur en essayant de lire la collecte de dons ou de publier un nouveau don externe. La suppression d’une collecte de dons est irréversible, et vous devez la considérer comme permanente. À ce stade, envisagez d’offrir à la personne concernée un moyen de se reconnecter à Facebook sur votre site pour créer une nouvelle collecte de dons.

R : La nouvelle collecte de dons sur Facebook reprendra de zéro et ne reflétera aucun don précédent. Pour tenir compte des dons précédents, publiez en tant que don externe tout dont reçu jusqu’à maintenant, y compris tout don reçu précédemment sur Facebook. Cela devrait garantir que le montant total recueilli correspond à ce qui est affiché sur votre site.

R : Vous pouvez choisir si vous souhaitez mettre fin à la collecte de dons Facebook ou non dans ces situations. Pour les transferts de participant·es, vous pouvez mettre à jour la date de fin via l’API pour vous assurer que la collecte de dons Facebook se termine à la même date que le nouvel évènement.

Dons Facebook

R : Nous prenons en charge les dons provenant d’une liste donnée de pays. Vous trouverez une liste de ces pays ici : https://facebook.com/help/837523116348786. Le bouton Faire un don sera grisé pour les personnes ne pouvant pas faire de don.

R : Il peut s’agir d’un problème au niveau de la carte que cette personne tente d’utiliser. Essayez de supprimer la carte des paramètres de paiement et de l’ajouter à nouveau : https://secure.facebook.com/settings?tab=payments&section=settings.

R : Vous pouvez télécharger des rapports sur les transactions à partir de la Page de l’organisation. Vous trouverez plus d’informations à la page suivante : https://facebook.com/help/1787615158233986.

R : Le webhook ne contient pas les informations de la personne ayant effectué le don, mais il contient un ID de paiement que vous pouvez mettre en correspondance avec les ID que vous trouverez dans les rapports sur les transactions.

Remboursement des dons

R : Actuellement, lorsqu’un don est remboursé, la collecte de dons sur Facebook ne reflète pas le remboursement, et le montant recueilli reste le même. Aucun évènement webhook n’est déclenché pour vous avertir du remboursement.

R : Si quelqu’un fait un don sur votre site puis demande un remboursement, vous devez faire en sorte que le montant du don reste synchronisé avec Facebook. Pour les remboursements complets, vous pouvez tout simplement supprimer le don externe que vous avez publié précédemment. Pour les remboursements partiels, vous pouvez supprimer le don externe puis en publier un nouveau, en mettant à jour le montant.