API da campanha de arrecadação de fundos – Perguntas frequentes

Disponibilidade

R: A API da campanha de arrecadação de fundos é pública e está disponível para os apps que são aprovados no fluxo de análise do app. Os apps podem ser de propriedade de uma organização sem fins lucrativos ou de um provedor de tecnologia. Para que uma campanha de arrecadação de fundos seja criada para uma organização sem fins lucrativos por meio da API, essa organização precisa estar integrada às ferramentas de campanhas de arrecadação de fundos da Meta aqui.

R: A API da campanha de arrecadação de fundos está disponível em países onde as organizações sem fins lucrativos podem se inscrever para ter acesso às Ferramentas de campanhas de arrecadação de fundos. Confira a lista de países com suporte aqui: https://facebook.com/help/1251484118194936.

Confira esta página para receber instruções sobre como ter acesso à API.

Teste

R: Todas as campanhas de arrecadação de fundos no Facebook são públicas, mas é possível criar uma campanha de arrecadação de fundos de teste visível somente para os desenvolvedores do seu app. Para isso, basta criar uma campanha de arrecadação de fundos usando o modo "Em desenvolvimento" do app. As campanhas de arrecadação de fundos criadas dessa forma mostrarão um banner na parte superior explicando que a campanha de arrecadação de fundos está visível apenas para programadores de apps. Ao mudar o modo do app de "Em desenvolvimento" para "Publicado", suas campanhas de arrecadação de fundos de teste continuarão ocultas para o público em geral. As campanhas de arrecadação de fundos criadas por um app "Publicado" permanecerão públicas mesmo que o app volte para "Em desenvolvimento".

R: O token de acesso do usuário na solicitação deve pertencer a um usuário real do Facebook. Você pode usar um app "Em desenvolvimento" para criar campanhas de arrecadação de fundos de teste ocultas do público em geral.

R: As campanhas de arrecadação de fundos criadas usando um app publicado ficarão ativas e publicamente visíveis, enquanto as campanhas de arrecadação de fundos criadas usando um app de desenvolvedor só ficam visíveis para os desenvolvedores e administradores. As campanhas de arrecadação de fundos publicadas e em desenvolvimento podem receber doações, mas os webhooks só são enviados quando o app está ativo.

R: Atualmente, não oferecemos suporte para doações de teste, e todas as doações devem ser feitas com uma credencial de pagamento válida. O valor mínimo de doação é de US$ 5, e você pode pedir um reembolso por meio do formulário de contacto indicado nesta página.

R: Os apps em modo de desenvolvimento não recebem um evento de webhook quando uma doação é feita, o que torna desafiadora a criação de um teste completo. Por esse motivo, há duas opções para testar o webhook: ativar manualmente um evento de webhook usando o painel do programador ou criar uma campanha de arrecadação de fundos por meio de um app "Em desenvolvimento" (para que a campanha de arrecadação de fundos não seja pública) e, em seguida, mudar o app para "Publicado" para que os webhooks possam ser recebidos quando você fizer uma doação.

Ações dos participantes

R: Embora não seja comum, é possível excluir uma campanha de arrecadação de fundos no Facebook. Se isso acontecer, todas as chamadas da Graph API que fizerem referência à campanha de arrecadação de fundos retornarão uma mensagem de erro. Como não há nenhum webhook para informar que uma campanha de arrecadação de fundos foi excluída em tempo real, você poderá tratar da exclusão quando receber uma mensagem de erro ao tentar ler a campanha de arrecadação de fundos ou publicar uma nova doação externa. Não é possível desfazer a exclusão de uma campanha de arrecadação de fundos, por isso as exclusões devem ser tratadas como definitivas. Neste ponto, você pode oferecer uma maneira para a pessoa se reconectar ao Facebook na central do participante para criar uma nova campanhas de arrecadação de fundos no Facebook.

R: A nova campanha de arrecadação de fundos no Facebook começará de novo e não refletirá as doações anteriores. Para contabilizar as doações anteriores, você deve postar como doações externas todas as doações recebidas até o momento, incluindo todas aquelas que você recebeu anteriormente no Facebook. Isso garante que o valor total arrecadado corresponda ao valor mostrado no site.

R: Nesses casos, você pode decidir se deseja encerrar a campanha de arrecadação de fundos do Facebook. Para transferências de participantes, você pode atualizar a data de término por meio da API para garantir que a campanhas de arrecadação de fundos do Facebook termine de acordo com a nova data do evento.

Doações do Facebook

R: Oferecemos suporte a doações de uma lista específica de países. Confira a lista completa de países aqui: https://facebook.com/help/837523116348786. O botão aparecerá esmaecido para pessoas que não puderem doar.

R: É possível que haja um problema com o cartão que o doador está a tentar usar. Experimente remover e adicionar novamente o cartão nas configurações de pagamento: https://secure.facebook.com/settings?tab=payments&section=settings.

R: Você pode baixar os relatórios de transações da Página da organização. Saiba mais aqui: https://facebook.com/help/1787615158233986.

R: O webhook não contém as informações do doador, mas contém a identificação do pagamento que você relacionar aos números de identificação nos relatórios de transações.

Reembolsos de doações

R: Atualmente, quando uma doação é reembolsada, a campanha de arrecadação de fundos do Facebook não reflete o reembolso, e o valor total arrecadado permanece o mesmo. Nenhum evento de webhook será ativado para notificar você sobre o reembolso.

R: Se alguém fizer uma doação no seu site e, posteriormente, solicitar um reembolso, mantenha o valor da doação sincronizado com o Facebook. Para reembolsos completos, você pode simplesmente eliminar a doação externa publicada anteriormente. Para reembolsos parciais, você pode excluir a doação externa e, em seguida, publicar uma nova com o valor atualizado.