籌款活動 API - 常見問題

適用對象

答：籌款活動 API 設為公開，適用於已通過應用程式審查流程的應用程式。這些應用程式可以是由非牟利機構或技術供應商擁有。若要透過 API 為非牟利機構建立募款活動，非牟利機構必須在此啟用 Meta 募款工具。

答：籌款活動 API 適用於非牟利機構可申請使用籌款工具的國家／地區。您可在此查看支援國家／地區清單：https://facebook.com/help/1251484118194936。

請參閱此頁面，了解有關取得 API 存取權限的指示。

測試

答：所有 Facebook 籌款活動均為公開，但您可以建立測試籌款活動，僅供您應用程式的開發人員查看。若要這樣做，您只需使用應用程式的「開發中」模式建立籌款活動即可。以此方式建立的籌款活動會在頂端顯示橫額，說明只有應用程式開發人員可以看到此籌款活動。將應用程式從「開發中」切換為「已上線」狀態後，測試用的籌款活動仍會繼續向大眾隱藏。由「已上線」應用程式建立的籌款活動會保持公開，即使您再次將應用程式設為「開發中」亦然。

答：要求中的用戶存取憑證必須屬於真實的 Facebook 用戶。您可以使用應用程式的「開發中」模式，建立不會向大眾顯示的測試用籌款活動。

答：使用已上線應用程式建立的籌款活動會發佈並公開顯示，至於使用開發人員應用程式建立的籌款活動，則只有應用程式的開發人員和管理員可以看到。已上線和開發模式的籌款活動都可以接收捐款，但只有在應用程式已上線時，系統才會傳送 Webhooks。

答：我們目前不支援測試捐款，所有捐款都必須透過有效的付款憑證來完成。您最少需捐出 $5 美元，而且可使用此頁面所列的聯絡表格提出退款要求。

答：處於開發模式的應用程式不會在有人捐款時收到 Webhook 事件，因此很難建立端對端測試。有見及此，您有兩個選項來測試 Webhook：您可以從開發人員管理中心手動觸發 Webhook 事件；或者使用處於「開發中」狀態的應用程式建立籌款活動（這樣籌款活動就不會公開），然後將應用程式切換為「已上線」狀態，這樣您便可在捐款時接收 Webhooks。

參與者動作

答：雖然此情況不常見，但用戶可以刪除其 Facebook 籌款活動。發生這種情況時，任何參照該籌款活動的 Graph API 呼叫都會傳回錯誤。由於沒有 Webhook 可以即時通知您籌款活動已被刪除，因此您可以在嘗試讀取籌款活動或發佈新的外部捐款但收到錯誤回應時，處理刪除事宜。刪除籌款活動後即無法復原，因此您應將此刪除操作視為永久刪除。此時，您或可讓對方透過您的參與者中心重新連結至 Facebook，以便對方在 Facebook 上建立新的籌款活動。

答：Facebook 上新的籌款活動將會重新開始，而且不會反映任何先前的捐款。若要計算之前的捐款，您應將目前收到的所有捐款發佈為外部捐款，包括先前在 Facebook 收到的任何捐款。這樣應該就能確保籌得的總金額與您網站上顯示的金額相符。

答：在這些情況下，您可以決定是否要結束 Facebook 籌款活動。如果參與者轉移到新活動，您可以透過 API 更新結束日期，以確保 Facebook 籌款活動能根據新的活動日期結束。

Facebook 捐款

答：我們支援用戶從特定國家／地區捐款。您可在此查看完整的國家／地區清單：https://facebook.com/help/837523116348786。無法捐款的用戶會看到捐款按鈕顯示為灰色。

答：捐款人嘗試使用的付款卡可能有問題。請嘗試在付款設定中移除付款卡，然後重新加入：https://secure.facebook.com/settings?tab=payments&section=settings。

答：您可以從機構的專頁下載交易報告。您可以在此查看更多相關資訊：https://facebook.com/help/1787615158233986。

答：Webhook 不會包含捐款人的資訊，但會包含付款編號，而您可以將之與交易報告中找到的編號配對。

捐款退款

答：目前當退還捐款時，Facebook 籌款活動並不會反映此筆退款，而且籌得的總金額會維持不變。系統不會觸發任何 Webhook 事件來通知您退款事宜。

答：如果有人在您的網站捐款之後要求退款，您應該與 Facebook 同步捐款金額。在全額退款的情況下，您只需刪除先前發佈的外部捐款即可。在部分退款的情況下，您可以刪除外部捐款，然後以更新後的金額發佈新的捐款。