API Penggalangan Dana - Pertanyaan Umum

Ketersediaan

J: API Penggalangan Dana bersifat publik dan tersedia untuk aplikasi. yang melalui alur peninjauan aplikasi. Aplikasi dapat dimiliki oleh organisasi nirlaba maupun penyedia layanan teknologi. Agar penggalangan dana dibuat untuk organisasi nirlaba melalui API, organisasi nirlaba harus digunakan ke alat Penggalangan Dana Meta di sini.

J: API Penggalangan Dana tersedia di negara-negara di mana organisasi nirlaba dapat mengajukan permohonan untuk Fitur Penggalangan Dana. Daftar negara yang didukung dapat ditemukan di sini: https://facebook.com/help/1251484118194936.

Lihat halaman ini untuk petunjuk tentang mendapatkan akses ke API.

Pengujian

J: Semua penggalangan dana di Facebook bersifat publik, tetapi memungkinkan untuk membuat penggalangan dana uji coba yang hanya terlihat oleh developer aplikasi Anda. Untuk melakukannya, Anda cukup membuat penggalangan dana menggunakan aplikasi dengan mode "dalam pengembangan". Penggalangan dana yang dibuat dengan cara ini akan menampilkan banner di bagian atas yang menjelaskan bahwa penggalangan dana hanya dapat dilihat oleh developer aplikasi. Saat mengganti aplikasi Anda dari mode "dalam pengembangan" ke "Tayang", pengumpulan dana uji coba Anda akan terus tersembunyi dari publik. Penggalangan dana yang dibuat oleh aplikasi dengan mode "Tayang" akan tetap publik bahkan jika aplikasi tersebut diatur kembali ke mode "Dalam pengembangan".

J: Token akses pengguna dalam permintaan haruslah milik pengguna Facebook sungguhan. Anda dapat menggunakan aplikasi dengan mode "Dalam pengembangan" untuk membuat penggalangan dana uji coba yang tersembunyi dari masyarakat umum.

J: Penggalangan dana yang dibuat menggunakan aplikasi tayang akan ditayangkan secara langsung dan terlihat oleh publik, sedangkan penggalangan dana yang dibuat menggunakan aplikasi pengembangan hanya terlihat oleh developer dan admin aplikasi. Penggalangan dana dengan mode tayang dan dalam pengembangan dapat menerima donasi, tetapi webhook hanya dikirim saat aplikasi sedang tayang.

J: Saat ini kami tidak mendukung donasi uji coba dan semua donasi harus dilakukan dengan kredensial pembayaran yang valid. Jumlah minimum yang dapat Anda donasikan adalah $5 dan Anda dapat meminta pengembalian dana menggunakan formulir kontak yang terdaftar di halaman ini.

J: Aplikasi dalam mode pengembangan tidak menerima acara webhook saat donasi dibuat, yang membuatnya menantang untuk membuat uji coba end-to-end. Karena ini, Anda memiliki dua opsi untuk menguji webhook: Anda dapat secara manual memicu acara webhook dari dasbor developer Anda; atau Anda dapat membuat penggalangan dana menggunakan aplikasi yang "Dalam Pengembangan" (agar penggalangan dana tidak akan menjadi publik) dan kemudian mengganti aplikasi ke mode "Tayang" sehingga webhook itu dapat diterima ketika Anda memberikan donasi.

Tindakan Peserta

J: Meskipun jarang, orang dapat menghapus penggalangan dananya di Facebook. Ketika ini terjadi, setiap panggilan API grafik yang merujuk pada penggalangan dana akan menampilkan eror. Karena tidak ada webhook untuk memberi tahu Anda bahwa penggalangan dana telah dihapus dalam waktu nyata, Anda dapat menangani penghapusan ketika Anda mendapatkan kembali pesan eror ketika mencoba membaca penggalangan dana atau memposting donasi eksternal baru. Menghapus penggalangan dana tidak dapat dibatalkan, jadi Anda harus menangani penghapusan secara permanen. Pada titik ini, Anda mungkin ingin menawarkan cara bagi orang tersebut untuk terhubung kembali ke Facebook di pusat peserta Anda untuk membuat penggalangan dana baru di Facebook.

J: Penggalangan dana baru di Facebook akan mulai dari awal dan tidak akan mencerminkan donasi sebelumnya. Untuk memperhitungkan donasi sebelumnya, Anda harus mengirimkan semua donasi yang telah diterima sejauh ini sebagai donasi eksternal, termasuk donasi yang sebelumnya sudah diterima di Facebook. Ini harus memastikan bahwa jumlah total yang dikumpulkan sesuai dengan apa yang ditampilkan di situs Anda.

J: Anda dapat memutuskan apakah Anda ingin mengakhiri Penggalangan Dana Facebook dalam kasus ini. Untuk pemindahan peserta, Anda dapat memperbarui tanggal akhir melalui api agar Penggalangan Dana Facebook berakhir sesuai dengan tanggal acara yang baru.

Donasi Facebook

J: Kami mendukung donasi dari daftar negara tertentu. Daftar negara yang didukung dapat ditemukan di sini: https://facebook.com/help/837523116348786. Orang yang tidak bisa menyumbang akan melihat tombol donasi berwarna abu-abu.

J: Mungkin ada masalah dengan kartu yang digunakan untuk donasi. Coba hapus dan tambahkan ulang kartu dari pengaturan pembayaran: https://secure.facebook.com/settings?tab=payments&section=settings.

J: Anda dapat mengunduh laporan transaksi dari Halaman organisasi. Anda bisa menemukan informasi selengkapnya di sini: https://facebook.com/help/1787615158233986.

J: Webhook tidak berisi informasi donatur, tetapi berisi ID pembayaran yang dapat Anda cocokkan dengan ID yang ditemukan dalam laporan transaksi.

Pengembalian Dana Donasi

J: Saat ini, ketika donasi dikembalikan, penggalangan dana di Facebook tidak akan mencerminkan pengembalian dana dan jumlah total yang dikumpulkan akan tetap sama. Tidak ada acara webhook yang akan dijalankan untuk memberi tahu Anda tentang pengembalian dana.

J: Jika seseorang menyumbang di situs Anda dan kemudian meminta pengembalian dana, Anda harus menjaga agar jumlah donasi selaras dengan Facebook. Untuk pengembalian dana penuh, Anda cukup menghapus donasi eksternal yang Anda posting sebelumnya. Untuk pengembalian dana sebagian, Anda dapat menghapus donasi eksternal dan kemudian memposting yang baru dengan jumlah yang diperbarui.