Часто задаваемые вопросы о Fundraiser API
Доступность
Соответствует ли моя некоммерческая организация требованиям для интеграции Fundraiser API?Fundraiser API общедоступен и предоставляется для приложений, которые проходят процесс проверки. Приложения могут принадлежать некоммерческой организации или поставщику технологий. Чтобы создать сбор пожертвований для некоммерческой организации через API, эта организация должна зарегистрироваться в инструментах Meta для сбора пожертвований здесь.
В каких странах доступна эта функция?Fundraiser API доступен во всех странах, где некоммерческие организации могут подать заявку на доступ к инструментам для сбора пожертвований. Список поддерживаемых стран можно найти здесь.
Как добавить Fundraiser API в свое приложение?Инструкции по получению доступа к API можно найти на этой странице.
Тестирование
Как создать тестовый сбор пожертвований?Все сборы пожертвований на Facebook общедоступны, но вы можете создать тестовый сбор пожертвований, который будет виден только разработчикам вашего приложения. Для этого можно просто создать сбор пожертвований с помощью приложения в режиме разработки. В верхней части такого сбора пожертвований появится баннер с указанием того, что этот сбор пожертвований виден только разработчикам приложения. Если приложение перевести из режима разработки в рабочий режим, тестовые сборы пожертвований останутся скрытыми от посторонних. Сборы пожертвований, созданные приложением в рабочем режиме, останутся общедоступными, даже если приложение снова будет переведено в режим разработки.
Можно ли создать сбор пожертвований от имени тестового пользователя?Маркер доступа пользователя в запросе должен принадлежать настоящему пользователю Facebook. Чтобы создать скрытый сбор пожертвований, вы можете использовать приложение в режиме разработки.
В чем разница между использованием приложения в режиме разработки и в рабочем режиме?Сбор пожертвований, созданный с помощью приложения в рабочем режиме, сразу же становится общедоступным. Сбор пожертвований, созданный с помощью приложения в режиме разработки, виден только разработчикам и администраторам приложения. Сборы пожертвований могут получать средства в любом из этих режимов, однако веб-перехватчики Webhooks будут отправляться, только если приложение находится в рабочем режиме.
Как тестировать пожертвования?Сейчас тестовые пожертвования не поддерживаются, поэтому все пожертвования должны совершаться с использованием действительных платежных данных. Вы можете отправить минимальную сумму пожертвования (5 долл. США) и запросить его возврат с помощью контактной формы, приведенной на этой странице.
Как тестировать веб-перехватчики Webhooks?Приложения в режиме разработки не получают событие Webhooks при совершении пожертвования, что затрудняет создание сквозного тестирования. Поэтому у вас есть два варианта для тестирования веб-перехватчиков: либо вручную запустить событие Webhooks на Панели разработчика, либо создать сбор пожертвований с помощью приложения в режиме разработки (чтобы сбор средств не стал общедоступным), а затем переключить это приложение на рабочий режим, чтобы начать получать веб-перехватчики при совершении пожертвования.
Действия участников
Что будет, если пользователь удалит свой сбор пожертвований через Facebook?В редких случаях люди могут удалить свой сбор пожертвований на Facebook. После этого любой вызов Graph API, ссылающийся на этот сбор пожертвований, будет возвращать ошибку. Раз отсутствует веб-перехватчик Webhooks, уведомляющий об удалении сбора пожертвований в режиме реального времени, вы можете обработать удаление, когда получите ошибку при попытке считать сбор пожертвований или опубликовать новое внешнее пожертвование. Удаление сбора пожертвований нельзя отменить, поэтому удаление нужно обработать как безвозвратное. На этом этапе вы можете предложить человеку возможность повторно подключиться к Facebook в вашем центре участников и создать новый сбор пожертвований на Facebook.
Что будет, если пользователь удалит один сбор пожертвований и создаст другой через API?Новый сбор пожертвований на Facebook начнется заново и не будет отражать предыдущие пожертвования. Чтобы учесть эти пожертвования, вам следует опубликовать в качестве внешних любые пожертвования, которые были получены до сих пор, в том числе полученные ранее на Facebook. Так общая собранная сумма будет соответствовать той, которая показывается на вашем сайте.
Как обрабатывать случаи, когда пользователь покидает мероприятие или переходит на новое?Вы можете решить, хотите ли вы завершить сбор пожертвований на Facebook в таких обстоятельствах. В случае перехода участника вы можете обновить через API дату окончания, чтобы сбор пожертвований на Facebook завершался в соответственно с ней.
Пожертвования на Facebook
Кто может совершать пожертвования или создавать сборы пожертвований на Facebook?Мы поддерживаем пожертвования только в определенных странах. Полный список стран можно найти здесь. Кнопка "Пожертвовать" будет неактивной для пользователей, которые не могут совершать пожертвования.
Почему при попытке совершить пожертвование дарители видят сообщение об ошибке?Возможно, возникла проблема с картой, которую пытается использовать даритель. Попробуйте удалить и снова добавить карту в настройках оплаты.
Как получить доступ к отчету по транзакциям, в котором приводятся пожертвования на Facebook?Вы можете скачать отчеты по транзакциям на Странице организации. Узнать больше можно здесь.
Можно ли получить информацию дарителя через веб-перехватчик Webhooks?Веб-перехватчик не содержит информацию дарителя, кроме ID платежа, который можно сопоставить с идентификаторами из отчетов по транзакциям.
Возврат пожертвований
Обновляется ли сбор пожертвований при возврате средств?Сейчас сбор пожертвований на Facebook не будет отражать возврат пожертвования, а общая собранная сумма не будет изменяться. При этом вам не будет срабатывать событие Webhooks, уведомляющее о возврате.
Как обрабатывать возвраты на сайте некоммерческой организации?Если кто-то совершит пожертвование на вашем сайте, а затем запросит его возврат, вам следует синхронизировать сумму пожертвования с Facebook. Для полных возвратов можно просто удалить ранее опубликованное внешнее пожертвование, а для частичных — удалить внешнее пожертвование и опубликовать новое с измененной суммой.