筹款活动 API — 常见问题解答

可用性

答：筹款活动 API 为公开资源，可用于通过应用审核流程的应用。应用的所有者可以是非营利组织，也可以是技术代理。若要通过 API 为非营利组织创建筹款活动，对应的非营利组织必须在此处接入 Meta 筹款工具。

答：在非营利组织能申请筹款工具的所有国家/地区，均可使用筹款活动 API。支持的国家/地区列表可在此处找到：https://facebook.com/help/1251484118194936。

如需有关获取 API 使用权限的说明，请参阅此页面。

测试

答：Facebook 上的所有筹款活动都是公开的，但也可以创建仅对应用开发者可见的测试筹款活动。对此，您只能使用“开发”模式下的应用创建筹款活动。以这种方式创建的筹款活动顶部会显示一个横幅，阐明该筹款活动仅对应用开发者可见。您将应用从“开发”模式切换到“上线”模式后，您的测试筹款活动仍会对公众隐藏。由“上线”模式的应用创建的筹款活动会保持公开，即便应用被设置回“开发”模式。

答：申请中的用户访问口令必须属于真实的 Facebook 用户。您可以使用“开发”模式的应用创建对公众隐藏的测试筹款活动。

答：使用上线模式应用创建的筹款活动会直接发布并公开可见，而使用开发模式应用创建的筹款活动仅对应用的开发者和管理员可见。“上线”和“开发”模式筹款活动均可接收捐款，但 Webhook 仅在应用“上线”后发送。

答：我们目前不支持测试捐款，所有捐款都必须使用有效的支付凭证进行。您可以捐赠的最小金额为 $5，您可以使用此页所列的联系表单申请退款。

答：处于开发模式的应用在发生捐款时，不会收到 Webhook 事件，因此难以创建端到端测试。鉴于此，您有两个方案可以测试 Webhook：一是通过开发者面板手动触发 Webhook 事件；二是使用“开发”模式下的应用创建筹款活动（因此筹款活动不会公开），然后将应用切换为“上线”模式，以便在您捐款时收到 Webhook。

参与者操作

答：虽然不常见，但用户可以在 Facebook 删除其筹款活动。如果出现这种情况，引用该筹款活动的所有图谱 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 同步。对于全额退款，您可以简单地删除之前发布的外部捐款。对于部分金额退款，您可以删除外部捐款，然后发布包含更新金额的新捐款。