API Chiến dịch gây quỹ - Câu hỏi thường gặp

Khả năng sử dụng

Đ: API Chiến dịch gây quỹ hiển thị công khai và dùng cho những ứng dụng đã vượt qua quy trình xét duyệt ứng dụng. Ứng dụng có thể thuộc sở hữu của tổ chức phi lợi nhuận hoặc nhà cung cấp công nghệ. Để tạo chiến dịch gây quỹ cho tổ chức phi lợi nhuận thông qua API này, tổ chức phi lợi nhuận phải tích hợp các Công cụ gây quỹ của Meta tại đây.

Đ: API Chiến dịch gây quỹ dùng được ở những quốc gia mà tổ chức phi lợi nhuận có thể đăng ký Công cụ gây quỹ. Bạn có thể xem danh sách quốc gia được hỗ trợ tại đây: https://facebook.com/help/1251484118194936.

Hãy tham khảo trang này để xem hướng dẫn nhận quyền truy cập vào API này.

Thử nghiệm

Đ: Mọi chiến dịch gây quỹ trên Facebook đều hiển thị công khai, nhưng bạn có thể tạo chiến dịch gây quỹ thử nghiệm chỉ hiển thị với nhà phát triển ứng dụng. Để thực hiện, bạn chỉ cần tạo chiến dịch gây quỹ bằng chế độ "Đang phát triển" trên ứng dụng. Chiến dịch gây quỹ được tạo theo cách này sẽ hiển thị biểu ngữ ở trên cùng, giải thích rằng chiến dịch gây quỹ này chỉ hiển thị với nhà phát triển ứng dụng. Khi bạn chuyển ứng dụng từ chế độ "Đang phát triển" sang "Chính thức", chiến dịch gây quỹ thử nghiệm vẫn sẽ ẩn với công chúng. Chiến dịch gây quỹ tạo bằng ứng dụng ở chế độ "Chính thức" vẫn sẽ hiển thị công khai ngay cả khi bạn chuyển về chế độ "Đang phát triển".

Đ: Mã truy cập người dùng trong yêu cầu phải thuộc về người dùng Facebook thực tế. Bạn có thể dùng chế độ "Đang phát triển" trên ứng dụng để tạo chiến dịch gây quỹ thử nghiệm không hiển thị với công chúng.

Đ: Chiến dịch gây quỹ tạo bằng ứng dụng ở chế độ chính thức sẽ hiển thị trực tiếp và công khai, trong khi chiến dịch gây quỹ tạo bằng ứng dụng ở chế độ đang phát triển sẽ chỉ hiển thị với quản trị viên và nhà phát triển ứng dụng. Các chiến dịch gây quỹ ở chế độ chính thức và đang phát triển có thể nhận khoản quyên góp, nhưng webhook chỉ được gửi đi khi ứng dụng ở chế độ chính thức.

Đ: Hiện tại, chúng tôi chưa hỗ trợ tính năng thử nghiệm hoạt động quyên góp và mọi khoản quyên góp đều phải được thực hiện bằng thông tin thanh toán hợp lệ. Số tiền tối thiểu mà bạn có thể quyên góp là 5 USD và bạn có thể yêu cầu hoàn tiền bằng mẫu liên hệ có trên trang này.

Đ: Ứng dụng ở chế độ đang phát triển sẽ không nhận được sự kiện webhook khi có người quyên góp. Điều này khiến cho việc tạo thử nghiệm đầu cuối không dễ dàng. Chính vì vậy, bạn có 2 cách để thử nghiệm webhook: (1) tự mình kích hoạt sự kiện webhook từ bảng điều khiển dành cho nhà phát triển hoặc (2) tạo chiến dịch gây quỹ bằng ứng dụng ở chế độ "Đang phát triển" (để chiến dịch gây quỹ không hiển thị công khai), sau đó chuyển ứng dụng sang chế độ "Chính thức" để hệ thống có thể nhận webhook khi bạn quyên góp.

Hành động của người tham gia

Đ: Mọi người có thể xóa chiến dịch gây quỹ của mình trên Facebook, dù rằng điều này hiếm khi xảy ra. Nếu trường hợp này xảy ra, mọi lệnh gọi API Đồ thị tham chiếu đến chiến dịch gây quỹ này đều sẽ trả về lỗi. Vì không có webhook để thông báo tức thì cho bạn rằng chiến dịch gây quỹ đã bị xóa, bạn có thể nắm được việc này khi nhận được lỗi trả về trong quá trình cố gắng đọc chiến dịch gây quỹ hoặc đăng khoản quyên góp bên ngoài mới. Quyết định xóa chiến dịch gây quỹ mang tính vĩnh viễn và không thể hoàn tác. Tại điểm này, bạn nên cung cấp cho người đó một cách để kết nối lại với Facebook trên trung tâm người tham gia của bạn để tạo chiến dịch gây quỹ mới trên Facebook.

Đ: Chiến dịch gây quỹ mới trên Facebook sẽ bắt đầu từ đầu và không thể hiện bất kỳ khoản quyên góp nào từ trước đó. Để ghi nhận các khoản quyên góp trước đó, bạn nên đăng dưới dạng khoản quyên góp bên ngoài đối với mọi khoản quyên góp mà mình nhận được cho đến nay, kể cả mọi khoản quyên góp từng nhận được trên Facebook. Điều này sẽ đảm bảo rằng tổng số tiền quyên góp được khớp với số liệu hiển thị trên trang web của bạn.

Đ: Bạn có thể quyết định liệu có kết thúc Chiến dịch gây quỹ trên Facebook hay không trong những trường hợp này. Đối với những lần chuyển của người tham gia, bạn có thể cập nhật ngày kết thúc thông qua API này để đảm bảo rằng Chiến dịch gây quỹ trên Facebook kết thúc theo ngày của sự kiện mới.

Quyên góp trên Facebook

Đ: Chúng tôi hỗ trợ khoản quyên góp từ danh sách các quốc gia cụ thể. Bạn có thể xem danh sách quốc gia đầy đủ tại đây: https://facebook.com/help/837523116348786. Những người không thể quyên góp sẽ nhìn thấy nút quyên góp được tô xám.

Đ: Có thể là do người quyên góp đang cố gắng dùng thẻ bị lỗi. Hãy thử gỡ rồi thêm lại thẻ đó trong phần cài đặt thanh toán: https://secure.facebook.com/settings?tab=payments&section=settings.

Đ: Bạn có thể tải báo cáo giao dịch xuống từ Trang của tổ chức. Bạn có thể tìm thêm thông tin tại đây: https://facebook.com/help/1787615158233986.

Đ: Webhook này không chứa thông tin của người quyên góp, nhưng có chứa ID thanh toán mà bạn có thể dùng để so khớp với ID trong báo cáo giao dịch.

Hoàn lại khoản quyên góp

Đ: Hiện tại, khi một khoản quyên góp được hoàn lại, chiến dịch gây quỹ trên Facebook sẽ không thể hiện khoản tiền hoàn lại đó và tổng số tiền gây quỹ được vẫn sẽ giữ nguyên. Hệ thống sẽ không kích hoạt sự kiện webhook nào để thông báo cho bạn về việc hoàn tiền.

Đ: Nếu ai đó quyên góp trên trang web của bạn nhưng sau đó lại yêu cầu hoàn tiền, bạn nên đảm bảo số tiền quyên góp luôn đồng bộ với Facebook. Đối với yêu cầu hoàn toàn bộ tiền, bạn chỉ cần xóa khoản quyên góp bên ngoài mà mình đã từng đăng. Đối với yêu cầu hoàn tiền một phần, bạn có thể xóa khoản quyên góp bên ngoài, rồi đăng khoản quyên góp mới có số tiền đã được cập nhật.