募金キャンペーンAPI - よくある質問
利用可否
Q: 非営利団体は募金キャンペーンAPI連携の利用対象ですか。A: 募金キャンペーンAPIは一般公開されており、アプリ審査プロセスを経たアプリで利用できます。このようなアプリは、非営利団体または技術プロバイダーのいずれかが所有できます。API経由で非営利団体向けの募金キャンペーンを作成するには、その非営利団体がこちらからMetaの募金キャンペーンツールにオンボーディングする必要があります。
Q: どの国で利用できますか。A: 募金キャンペーンAPIは、非営利団体が募金キャンペーンツールを申請できる国で利用できます。サポート対象国の一覧は、https://facebook.com/help/1251484118194936でご確認いただけます。
Q: 募金キャンペーンAPIをアプリに追加するにはどうすればよいですか。APIへのアクセスを得る方法については、こちらのページをご覧ください。
テスト
Q: テスト用の募金キャンペーンを作成するにはどうすればよいですか。A: Facebook上の募金キャンペーンはすべて公開されますが、ご利用のアプリの開発者のみに表示されるテスト用の募金キャンペーンを作成することは可能です。その場合は、単に「開発」モードのアプリで募金キャンペーンを作成します。この方法で作成した募金キャンペーンの上部には、それがアプリの開発者のみに表示されることを示すバナーが表示されます。アプリを「開発」モードから「ライブ」モードに切り替えても、テスト用の募金キャンペーンが一般公開されることはありません。「ライブ」モードのアプリで作成された募金キャンペーンは、アプリを「開発」モードに戻しても引き続き公開されたままになります。
Q: テストユーザーを使って募金キャンペーンを作成できますか。A: リクエストに使用するユーザーアクセストークンは、実際のFacebookユーザーに紐づいている必要があります。「開発」モードのアプリを使用すれば、一般公開されないテスト用の募金キャンペーンを作成できます。
Q: アプリの「開発」モードと「ライブ」モードの違いは何ですか。A: 「ライブ」モードのアプリで作成された募金キャンペーンはライブの状態で公開されます。一方、「開発」モードのアプリで作成された募金キャンペーンは、そのアプリの開発者と管理者にのみ表示されます。ライブモードおよび開発モードの募金キャンペーンはいずれも寄付を受け取ることができますが、Webhooksが送信されるのはアプリがライブのときのみです。
Q: 寄付をテストするにはどうすればよいですか。A: 現在、寄付のテストはサポートされておらず、すべての寄付は有効な支払い認証情報を使用して行う必要があります。寄付できる最小金額は5ドルで、返金を希望する場合はこのページに記載されているお問い合わせフォームから申請できます。
Q: Webhooksをテストするにはどうすればいいですか。A: 開発モードのアプリでは、寄付が行われてもWebhookイベントが送信されないため、エンドツーエンドのテストを作成するのが困難になります。そのため、Webhookをテストする方法は、開発者ダッシュボードからWebhookイベントを手動でトリガーするか、「開発」モードのアプリで募金キャンペーンを作成し(この募金キャンペーンは公開されません)、その後アプリを「ライブ」モードに切り替えて寄付を行い、Webhookを受信するかのいずれかになります。
参加者のアクション
Q: ユーザーがFacebookを介して募金キャンペーンを削除した場合、どうなりますか。A: 一般的ではありませんが、Facebook上で募金キャンペーンを削除することは可能です。この場合、その募金キャンペーンを参照するグラフAPIの呼び出しによってエラーが返されます。募金キャンペーンが削除されたことをリアルタイムで伝えるWebhookは存在しません。そのため、募金キャンペーンの読み込みや外部からの新しい寄付の投稿を試みられた際にエラーが返された場合、それを削除として処理することができます。募金キャンペーンを削除すると元に戻すことはできないため、削除は恒久的なものとして処理する必要があります。削除後に、参加者センターでFacebookに再接続して、新しい募金キャンペーンを作成できるようにする方法を提供することをおすすめします。
Q: ユーザーが募金キャンペーンを削除した後にAPI経由で新しい募金キャンペーンを作成した場合はどうなりますか。A: Facebook上で作成された新しい募金キャンペーンは、ゼロから開始され、過去の寄付は一切反映されません。過去の寄付を反映させるには、これまでに受け取ったすべての寄付(Facebook上で受け取ったものを含む)を外部寄付として投稿する必要があります。これにより、集まった寄付の合計金額があなたのサイトに表示される金額と一致するようになります。
Q: ユーザーがイベントを離れたり、別のイベントに移動したりする場合は、どのように対応すればよいですか。A: そのような場合、Facebook上の募金キャンペーンを終了させるかどうかは任意で判断できます。参加者の移動があった場合は、APIを使って終了日を更新することで、Facebook上の募金キャンペーンを新しいイベントの日程に合わせて終了させることができます。
Facebookでの寄付
Q: 誰がFacebookで寄付を行ったり、募金キャンペーンを作成したりできますか。A: 特定の国からの寄付のみがサポートされています。サポート対象国の完全なリストについては、https://facebook.com/help/837523116348786でご確認いただけます。寄付できないユーザーには、寄付ボタンがグレーアウトされます。
Q: 寄付しようとした際に、寄付者にエラーメッセージが表示されるのはなぜですか。A: 寄付者が使用しようとしているカードに問題がある可能性があります。https://secure.facebook.com/settings?tab=payments§ion=settingsで、一度そのカードを支払い設定から削除し、再度追加してみてください。
Q: Facebookで受け取った寄付を表示する取引レポートにアクセスするにはどうすればよいですか。A: 取引レポートは、団体のFacebookページからダウンロードできます。詳しくは、https://facebook.com/help/1787615158233986をご覧ください。
Q: Webhookを介して寄付者の情報を取得することはできますか。A: Webhookには寄付者の情報は含まれていませんが、支払いIDが含まれているため取引レポートに記載されているIDと照合することができます。
寄付の返金
Q: 返金が行われた場合、募金キャンペーンは更新されますか。A: 現時点では、寄付が返金されてもFacebook上の募金キャンペーンには反映されず、集まった寄付の合計額は更新されません。返金が行われても、それを通知するWebhookイベントは送信されません。
Q: 非営利団体のサイトでは、返金をどのように処理すればよいですか。A: 誰かがあなたのサイトで寄付を行い、その後返金を求めた場合は、寄付金額をFacebook上の金額と同期させるようにしてください。全額返金の場合は、以前に投稿した外部寄付を単に削除できます。一部返金の場合は、外部寄付をいったん削除し、返金後の金額で新たに投稿し直すことができます。