募款活動 API - 常見問題

開放使用狀態

A：募款活動 API 為公開資源，提供給通過應用程式審核流程的應用程式使用，可以是非營利組織或技術供應商所擁有的應用程式。若要透過 API 為非營利組織建立募款活動，該非營利組織必須前往這裡註冊 Meta 募款工具。

A：只要是非營利組織可申請使用募款工具的國家／地區，皆可使用募款活動 API。支援的國家／地區清單請參見：https://facebook.com/help/1251484118194936。

若需取得 API 存取權限的相關說明，請參閱此頁面。

測試

A：刊登於 Facebook 的所有募款活動都會公開顯示，不過您可以建立只有應用程式開發人員可查看的測試募款活動。只要使用應用程式的「調整中」模式，就能建立測試募款活動。以這種方式建立募款活動後，募款活動頂端會顯示橫幅，說明募款活動僅限應用程式開發人員查看。將應用程式從「調整中」切換為「已上線」後，測試募款活動仍會維持向一般用戶隱藏的狀態。由「已上線」應用程式建立的募款活動則會維持公開狀態，即便將應用程式重新設定為「調整中」亦然。

A：要求中的用戶存取權杖必須由真實的 Facebook 用戶持有。您可使用處於「調整中」模式的應用程式，建立向一般用戶隱藏的測試募款活動。

A：以「已上線」應用程式建立的募款活動會上線並公開顯示，而以「調整中」應用程式建立的募款活動，則只有應用程式的開發人員和管理員可查看。無論處於「已上線」或「調整中」模式，募款活動都能接受捐款，但只有當應用程式已上線時，才會傳送 Webhook。

A：目前並不支援測試捐款，所有捐款皆須使用有效的付款憑證。捐款金額下限為 $5 美元，若要申請退款，可使用本頁面列出的聯絡表單。

A：處於「調整中」模式的應用程式不會在有人捐款時收到 Webhook 事件，因此難以建立端對端測試。因此，您有兩個選項可以測試 Webhook：從開發人員主控板手動觸發 Webhook 事件；或使用「調整中」應用程式建立募款活動（如此募款活動才不會公開顯示），接著將應用程式切換為「已上線」，即可在有人捐款時收到 Webhook。

參與者動作

A：儘管不常見，但用戶可以在 Facebook 刪除他們的募款活動。若刪除募款活動，所有參照該募款活動的圖形 API 呼叫都會傳回錯誤訊息。由於沒有 Webhook 即時通知您募款活動已經刪除，您可以在嘗試讀取募款活動或是發佈新的外部捐款，卻收到傳回的錯誤訊息時，才處理刪除作業。募款活動一旦刪除便無法復原，處理時應注意此為永久刪除。此時，建議您在參與者中心提供重新連結至 Facebook 的方法，讓對方能在 Facebook 建立新募款活動。

A：新的 Facebook 募款活動會重新開始，不會反映先前的任何捐款。若要反映先前的捐款，您應將截至目前收到的捐款發佈為外部捐款，包括先前在 Facebook 收到的任何捐款。這樣應該就能確保募得的總金額與網站顯示的金額相符。

A：發生這些情況時，您可決定是否結束 Facebook 募款活動。若是參與者移轉，您可透過 API 更新結束日期，以確保 Facebook 募款活動依據新的活動日期如期結束。

Facebook 捐款

A：目前已開放特定國家／地區的用戶捐款。支援的完整國家／地區清單請參見：https://facebook.com/help/837523116348786。無法捐款的用戶會看見灰色的捐款按鈕。

A：可能是捐款人嘗試使用的卡片發生問題。請嘗試從付款設定移除該卡片並再次新增：https://secure.facebook.com/settings?tab=payments&section=settings。

A：您可以從組織的粉絲專頁下載交易報告。如需詳細資訊，請參閱：https://facebook.com/help/1787615158233986。

A：Webhook 不含捐款人資料，但能提供付款編號，供您比對交易報告中的編號。

捐款退款

A：目前退還款項後，Facebook 募款活動不會反映退款金額，募得的總金額仍會維持不變。系統不會觸發 Webhook 事件通知您這筆退款。

A：如果有人在您網站上捐款，但後來申請退款，捐款金額應與 Facebook 維持同步。若是全額退款，只要刪除先前發佈的外部捐款即可。若是部分退款，您可以先刪除外部捐款，再發佈新的捐款以反映更新金額。