API Fundraiser - FAQ

Disponibilità

R: L'API Fundraiser è pubblica e disponibile per le app che superano il flusso di analisi dell'app. Le app possono essere di proprietà di un'organizzazione no profit o di un fornitore di soluzioni tecnologiche. Per creare una raccolta fondi per un'organizzazione no profit tramite l'API, l'organizzazione no profit deve essere integrata negli strumenti per le raccolte fondi di Meta qui.

R: L'API Fundraiser è disponibile nei Paesi in cui le organizzazioni no profit possono richiedere strumenti per le raccolte fondi. L'elenco dei Paesi supportati è disponibile qui: https://facebook.com/help/1251484118194936 .

Vedi questa pagina per istruzioni su come accedere all'API.

Test

R: Tutte le raccolte fondi su Facebook sono pubbliche, ma è possibile creare una raccolta fondi di prova visibile solo agli sviluppatori della tua app. Per farlo, puoi semplicemente creare una raccolta fondi usando un'app in modalità sviluppo. Le raccolte fondi create in questo modo mostreranno un banner in alto che spiega che la raccolta fondi è visibile solo agli sviluppatori di app. Quando passi la tua app dalla modalità sviluppo a quella live, le tue raccolte fondi di prova continueranno a rimanere nascoste al pubblico. Le raccolte fondi create da un'app live rimarranno pubbliche anche se l'app è impostata sulla modalità sviluppo.

R: Il token d'accesso dell'utente nella richiesta deve appartenere a un utente Facebook effettivo. Puoi usare un'app in modalità sviluppo per creare raccolte fondi di prova nascoste al pubblico.

R: Le raccolte fondi create usando un'app live saranno live e visibili pubblicamente, mentre le raccolte fondi create usando un'app per sviluppatori sono visibili solo agli sviluppatori e agli amministratori dell'app. Le raccolte fondi in modalità live e sviluppatori possono ricevere donazioni, ma i webhook vengono inviati solo quando l'app è attiva.

R: Al momento non supportiamo le donazioni di prova e tutte le donazioni devono essere effettuate con credenziali di pagamento valide. L'importo minimo che puoi donare è di 5 $ e puoi richiedere un rimborso utilizzando il modulo di contatto indicato su questa pagina.

R: Le app in modalità sviluppo non ricevono un evento webhook quando viene fatta una donazione, il che rende difficile creare un test end-to-end. Per questo motivo, per testare il webhook hai a disposizione due opzioni: puoi attivare manualmente un evento webhook dalla tua dashboard per sviluppatori, oppure creare una raccolta fondi usando un'app in modalità sviluppo (in modo che la raccolta fondi non sia pubblica). Poi, puoi passare l'app in modalità live in modo che i webhooks possano essere ricevuti quando fai una donazione.

Azioni dei partecipanti

R: Anche se avviene di rado, le persone possono eliminare la loro raccolta fondi su Facebook. Quando questo accade, qualsiasi chiamata API Graph che faccia riferimento alla raccolta fondi restituirà un errore. Poiché non esiste un webhook che ti informi in tempo reale dell'eliminazione di una raccolta fondi, puoi gestire l'eliminazione quando ricevi un errore quando provi a leggere la raccolta fondi o a pubblicare una nuova donazione esterna. L'eliminazione di una raccolta fondi non può essere annullata, quindi dovresti gestire questa azione come permanente. A questo punto, potresti voler offrire alla persona un modo per riconnettersi a Facebook nel tuo centro partecipanti per creare una nuova raccolta fondi su Facebook.

R: La nuova raccolta fondi su Facebook ripartirà da zero e non terrà conto delle donazioni precedenti. Per tenere conto delle donazioni precedenti, dovresti pubblicare qualsiasi donazione ricevuta fino a quel momento come donazione esterna, comprese le donazioni ricevute in precedenza su Facebook. Così facendo, l'importo totale raccolto dovrebbe corrispondere a quello mostrato sul tuo sito.

R: In questi casi, puoi decidere se vuoi terminare la raccolta fondi di Facebook. Per i trasferimenti dei partecipanti, puoi aggiornare la data di fine tramite l'API per assicurarti che la raccolta fondi di Facebook termini in base alla nuova data dell'evento.

Donazioni di Facebook

R: Sosteniamo le donazioni provenienti da un elenco specifico di Paesi. Un elenco completo dei Paesi è disponibile qui: https://facebook.com/help/837523116348786 . Le persone che non possono donare vedranno il pulsante Fai una donazione disattivato.

R: Potrebbe esserci un problema con la carta che il donatore sta cercando di usare. Prova a rimuovere e aggiungere nuovamente la carta dalle impostazioni di pagamento: https://secure.facebook.com/settings?tab=payments&section=settings .

R: Puoi scaricare i report sulle transazioni dalla Pagina dell'organizzazione. Puoi trovare maggiori informazioni qui: https://facebook.com/help/1787615158233986 .

R: Il webhook non contiene informazioni sul donatore, ma contiene un ID di pagamento che puoi confrontare con gli ID presenti nei report delle transazioni.

Rimborsi per le donazioni

R: Al momento, quando una donazione viene rimborsata, la raccolta fondi su Facebook non rifletterà il rimborso e l'importo totale raccolto rimarrà invariato. Nessun evento webhook verrà attivato per informarti del rimborso.

R: Se qualcuno fa una donazione sul tuo sito e in seguito chiede un rimborso, l'importo della donazione dovrebbe essere sincronizzato con Facebook. Per rimborsi completi, puoi semplicemente eliminare la donazione esterna che hai pubblicato in precedenza. Per i rimborsi parziali, puoi eliminare la donazione esterna e poi pubblicarne una nuova con l'importo aggiornato.