기부 캠페인 API - FAQ
사용 가능 여부
Q: 비영리 단체에서 기부 캠페인 API와 통합할 수 있나요?A: 기부 캠페인 API는 전체 공개되며 앱 검수 플로를 통과한 앱에서 사용할 수 있습니다. 앱은 비영리 단체나 기술 제공업체에서 소유할 수 있습니다. API를 통해 비영리 단체를 위한 기부 캠페인을 만들려면 여기에서 비영리 단체가 Meta 기부 캠페인 도구에 온보딩되어 있어야 합니다.
Q: 지원되는 국가는 어디인가요?A: 비영리 단체가 기부 캠페인 도구를 신청할 수 있는 국가에서 기부 캠페인 API를 사용할 수 있습니다. 지원되는 국가 리스트는 여기(https://facebook.com/help/1251484118194936)에서 확인할 수 있습니다.
Q: 기부 캠페인 API를 앱에 추가하려면 어떻게 해야 하나요?API에 액세스하는 방법에 관한 지침은 이 페이지를 확인하세요.
테스트
Q: 테스트 기부 캠페인은 어떻게 만들 수 있나요?A: Facebook의 모든 기부 캠페인은 전체 공개되어 있지만, 앱 개발자에게만 표시되는 테스트 기부 캠페인을 만들 수 있습니다. 앱 '개발 중' 모드를 사용하여 기부 캠페인을 만들기만 하면 됩니다. 이렇게 만든 기부 캠페인에는 상단에 앱 개발자만 해당 기부 캠페인을 볼 수 있다고 설명하는 배너가 표시됩니다. 앱을 '개발 중'에서 '라이브'로 전환해도 테스트 기부 캠페인은 계속해서 일반 대중에게 숨김 처리됩니다. '라이브' 앱에서 만든 기부 캠페인은 앱이 다시 '개발 중'으로 설정되어도 전체 공개로 유지됩니다.
Q: 테스트 사용자를 통해 기부 캠페인을 만들 수 있나요?A: 요청에 포함된 사용자 액세스 토큰은 실제 Facebook의 소유자여야 합니다. 앱 '개발 중' 모드를 사용하여 일반 대중에게 숨김 처리된 테스트 기부 캠페인을 만들 수 있습니다.
Q: '개발 중'인 앱과 '라이브'인 앱의 차이는 무엇인가요?A: 라이브 앱을 사용하여 만든 기부 캠페인은 게시되어 전체 공개로 표시되지만, 개발 앱을 사용하여 만든 기부 캠페인은 앱 개발자 및 관리자에게만 표시됩니다. 라이브 및 개발 모드 기부 캠페인은 기부금을 수령할 수 있지만, Webhooks는 앱이 라이브 상태일 때만 전송됩니다.
Q: 기부를 테스트하려면 어떻게 해야 하나요?A: 현재 테스트 기부가 지원되지 않으며 모든 기부는 유효한 결제 자격 증명으로 이루어져야 합니다. 기부할 수 있는 최소 금액은 5달러이며, 이 페이지에 나열된 연락처 양식을 사용하여 환불을 요청할 수 있습니다.
Q: Webhooks를 테스트하려면 어떻게 해야 하나요?A: 개발 모드인 앱은 기부가 이루어질 때 Webhooks 이벤트를 수신하지 않으므로 종단간 테스트를 만들기가 어렵습니다. 이러한 이유로 두 가지 옵션으로 Webhooks를 테스트할 수 있습니다. 개발자 대시보드에서 수동으로 Webhooks 이벤트를 트리거하거나, 또는 기부 캠페인이 전체 공개되지 않도록 '개발 중'인 앱을 사용하여 기부 캠페인을 만든 다음 앱을 '라이브'로 전환하여 기부가 이루어질 때 Webhooks를 수신하도록 할 수 있습니다.
참여자 행동
Q: 사용자가 Facebook을 통해 기부 캠페인을 삭제하면 어떻게 되나요?A: 드물지만 사람들이 Facebook에서 기부 캠페인을 삭제할 수 있습니다. 이러한 경우 기부 캠페인을 참조하는 모든 그래프 API 호출이 오류를 반환합니다. 기부 캠페인이 삭제되었다는 사실을 실시간으로 알려주는 Webhooks가 없으므로, 기부 캠페인을 읽거나 새 외부 기부를 게시하려고 할 때 오류가 발생하면 삭제 처리할 수 있습니다. 기부 캠페인을 삭제하면 취소할 수 없으므로 영구적으로 삭제를 처리해야 합니다. 이때 참여자 센터에서 Facebook에 다시 연결하여 Facebook에 새로운 기부 캠페인을 만들 수 있는 방법을 제공할 수 있습니다.
Q: 사용자가 기부 캠페인을 삭제한 다음 나중에 API를 통해 새로 만들면 어떻게 되나요?A: Facebook의 새로운 기부 캠페인이 새로 시작되며 이전 기부는 반영되지 않습니다. 이전 기부금을 고려하려면 Facebook에서 이전에 수령한 기부금을 포함하여 지금까지 수령한 기부금을 외부 기부금으로 게시해야 합니다. 이 경우 총 모금액이 사이트에 표시된 금액과 일치하는지 확인해야 합니다.
Q: 사용자가 이벤트를 나가거나 새로운 이벤트로 이동하는 경우 어떻게 처리해야 하나요?A: 이러한 경우 Facebook 기부 캠페인 종료 여부를 결정할 수 있습니다. 참여자가 이동하는 경우 Facebook 기부 캠페인이 새로운 이벤트 날짜에 따라 종료되도록 API를 통해 종료일을 업데이트할 수 있습니다.
Facebook 기부
Q: Facebook에서 기부하거나 기부 캠페인을 만들 수 있는 사람은 누구인가요?A: Facebook에서는 특정 국가 리스트의 기부를 지원합니다. 여기(https://facebook.com/help/837523116348786)에서 전체 국가 리스트를 확인할 수 있습니다. 기부할 수 없는 사람은 기부 버튼이 회색으로 표시됩니다.
Q: 기부하려고 할 때 기부자에게 오류 메시지가 표시되는 이유는 무엇인가요?A: 기부자가 사용하려고 하는 카드에 문제가 있을 수도 있습니다. 결제 설정(https://secure.facebook.com/settings?tab=payments§ion=settings)에서 카드를 삭제하고 다시 추가해보세요.
Q: Facebook에서 수령한 기부금을 보여주는 거래 보고서에 어떻게 액세스할 수 있나요?A: 단체 페이지에서 거래 보고서를 다운로드할 수 있습니다. 자세한 내용은 여기(https://facebook.com/help/1787615158233986)에서 확인할 수 있습니다.
Q: Webhooks를 통해 기부자 정보를 확인할 수 있나요?A: Webhooks에는 기부자 정보가 포함되어 있지 않지만, 거래 보고서에 있는 ID와 일치할 수 있는 결제 ID가 포함되어 있습니다.
기부금 환불
Q: 환불이 진행되면 기부 캠페인이 업데이트되나요?A: 현재 기부금이 환불되면 Facebook 기부 캠페인에 환불금이 반영되지 않으며 총 모금액이 그대로 유지됩니다. 환불을 알리는 Webhooks 이벤트는 발생하지 않습니다.
Q: 비영리 단체 사이트에서 환불을 어떻게 처리해야 하나요?A: 누군가가 사이트에 기부한 후 나중에 환불을 요청하는 경우 기부 금액을 Facebook과 동기화해야 합니다. 전액 환불의 경우 이전에 게시한 외부 기부금을 삭제하기만 하면 되고, 부분 환불의 경우 외부 기부금을 삭제한 다음 업데이트된 금액으로 새로 게시하면 됩니다.