API โครงการระดมทุน - คำถามที่พบบ่อย
ความพร้อมใช้งาน
ถาม: องค์กรไม่แสวงผลกำไรของฉันมีสิทธิ์ผสานการทำงานกับ API โครงการระดมทุนหรือไม่ตอบ: API โครงการระดมทุนเป็นบริการสาธารณะและใช้งานได้สำหรับแอพที่ผ่านขั้นตอนการตรวจสอบแอพแล้ว โดยแอพดังกล่าวจะเป็นของผู้ให้บริการเทคโนโลยีหรือเป็นขององค์กรไม่แสวงผลกำไรเองก็ได้ หากต้องการสร้างโครงการระดมทุนให้กับองค์กรไม่แสวงผลกำไรผ่าน API องค์กรไม่แสวงผลกำไรต้องเริ่มต้นใช้งานเครื่องมือระดมทุนของ Meta ที่นี่
ถาม: รองรับประเทศใดบ้างถาม: API โครงการระดมทุนเปิดให้ใช้งานในประเทศที่องค์กรไม่แสวงผลกำไรสามารถสมัครใช้งานเครื่องมือระดมทุนได้ คุณสามารถดูรายชื่อประเทศที่รองรับได้ที่นี่: https://facebook.com/help/1251484118194936
ถาม: ฉันจะเพิ่ม API โครงการระดมทุนไปยังแอพของฉันได้อย่างไรดูคำแนะนำในการรับสิทธิ์เข้าใช้งาน API ได้ที่หน้านี้
การทดสอบ
ถาม: ฉันจะสร้างโครงการระดมทุนได้อย่างไรตอบ: โครงการระดมทุนบน Facebook ทั้งหมดเป็นสาธารณะ แต่คุณก็สามารถสร้างโครงการระดมทุนทดสอบที่จะมีเพียงผู้พัฒนาแอพของคุณเท่านั้นที่เห็นได้ วิธีการคือ ให้คุณสร้างโครงการระดมทุนขึ้นมาโดยใช้โหมด "อยู่ระหว่างการพัฒนา" ของแอพ โครงการระดมทุนที่สร้างขึ้นด้วยวิธีนี้จะมีแบนเนอร์แสดงอยู่ด้านบนเพื่อบอกว่าจะมีเพียงผู้พัฒนาแอพเท่านั้นที่เห็นโครงการระดมทุนนี้ เมื่อสลับโหมดแอพของคุณจาก "อยู่ระหว่างการพัฒนา" เป็น "เผยแพร่" ระบบก็จะยังซ่อนโครงการระดมทุนทดสอบของคุณเอาไว้ไม่ให้คนทั่วไปเห็นเป็นสาธารณะ โครงการระดมทุนที่สร้างโดยแอพในโหมด "เผยแพร่" จะเป็นสาธารณะต่อไปแม้ว่าจะตั้งค่าแอพกลับเป็นโหมด "อยู่ระหว่างการพัฒนา" ก็ตาม
ถาม: ฉันสามารถสร้างโครงการระดมทุนโดยใช้ผู้ใช้ทดสอบได้หรือไม่ตอบ: โทเค็นการเข้าถึงของผู้ใช้ในคำขอต้องเป็นของผู้ใช้ Facebook ที่มีตัวตนจริง คุณสามารถใช้แอพในโหมด "อยู่ระหว่างการพัฒนา" เพื่อสร้างโครงการระดมทุนทดสอบที่จะซ่อนไม่ให้คนทั่วไปเห็นเป็นสาธารณะได้
ถาม: แอพที่อยู่ในโหมด "อยู่ระหว่างการพัฒนา" หรือ "เผยแพร่" มีความแตกต่างกันอย่างไรตอบ: โครงการระดมทุนที่สร้างโดยใช้แอพในโหมดเผยแพร่จะเผยแพร่ให้เห็นได้โดยสาธารณะ ส่วนโครงการระดมทุนที่สร้างโดยใช้แอพในโหมดอยู่ระหว่างการพัฒนาจะมีเพียงผู้พัฒนาและผู้ดูแลของแอพเท่านั้นที่เห็นได้ โครงการระดมทุนในโหมดเผยแพร่และอยู่ระหว่างการพัฒนาจะรับยอดบริจาคได้ แต่ระบบจะส่ง Webhook เฉพาะเมื่อแอพอยู่ในโหมดเผยแพร่เท่านั้น
ถาม: ฉันจะทดสอบการบริจาคได้อย่างไรตอบ: ในขณะนี้ เราไม่รองรับการบริจาคทดสอบและการบริจาคทุกรายการจะต้องดำเนินการโดยใช้ข้อมูลประจำตัวในการชำระเงินที่ถูกต้อง จำนวนเงินขั้นต่ำที่คุณจะบริจาคได้คือ 5 ดอลลาร์ ซึ่งคุณสามารถขอคืนได้โดยกรอกแบบฟอร์มติดต่อที่มีให้ในหน้านี้
ถาม: ฉันจะทดสอบ Webhook ได้อย่างไรตอบ: แอพในโหมดอยู่ระหว่างการพัฒนาจะไม่ได้รับเหตุการณ์ Webhook เมื่อทำการบริจาค ซึ่งจะทำให้คุณทดสอบกระบวนการตั้งแต่ต้นจนจบได้ยาก ด้วยเหตุนี้ เราจึงมีวิธีทดสอบ Webhook ให้คุณเลือก 2 วิธี นั่นคือคุณสามารถกระตุ้นการทำงานของเหตุการณ์ Webhook ด้วยตนเองจากแดชบอร์ดผู้พัฒนาของคุณ หรือคุณจะสร้างโครงการระดมทุนโดยใช้แอพในโหมด "อยู่ระหว่างการพัฒนา" (เพื่อไม่ให้โครงการระดมทุนเผยแพร่เป็นสาธารณะ) แล้วสลับแอพเป็นโหมด "เผยแพร่" เพื่อให้ระบบสามารถรับ Webhook เมื่อคุณทำการบริจาคก็ได้
การดำเนินการของผู้เข้าร่วม
ถาม: จะเกิดอะไรขึ้นหากผู้ใช้ลบโครงการระดมทุนของตนผ่าน Facebookตอบ: แม้ว่ากรณีนี้พบได้ไม่บ่อยนัก แต่ผู้ใช้ก็สามารถลบโครงการระดมทุนบน Facebook ของตนได้ เมื่อลบแล้ว การเรียก API กราฟใดก็ตามที่อ้างอิงถึงโครงการระดมทุนดังกล่าวจะส่งคืนข้อผิดพลาดกลับมา โดยเมื่อไม่มี Webhook ที่จะบอกให้คุณทราบได้แบบเรียลไทม์ว่าโครงการระดมทุนถูกลบไปแล้ว คุณก็จะได้จัดการกับการลบดังกล่าวเฉพาะเมื่อคุณได้รับข้อผิดพลาดกลับคืนมาขณะที่พยายามดึงข้อมูลโครงการระดมทุนหรือพยายามโพสต์การบริจาคภายนอกรายการใหม่เท่านั้น การลบโครงการระดมทุนเป็นการดำเนินการที่ยกเลิกไม่ได้ คุณจึงควรถือว่าการลบดังกล่าวมีผลถาวร ในขั้นนี้ คุณสามารถเสนอช่องทางให้ผู้ใช้กลับไปยัง Facebook ได้ในศูนย์ผู้มีส่วนร่วมของคุณเพื่อสร้างโครงการระดมทุนใหม่บน Facebook
ถาม: จะเกิดอะไรขึ้นหากผู้ใช้ลบโครงการระดมทุนของตนและสร้างโครงการระดมทุนใหม่หลังจากนั้นผ่าน APIตอบ: โครงการระดมทุนใหม่ดังกล่าวบน Facebook จะสร้างขึ้นใหม่โดยสิ้นเชิงและไม่มียอดบริจาคใดก็ตามที่ผ่านมาอยู่เลย หากต้องการเก็บข้อมูลการบริจาคที่ผ่านมาเอาไว้ คุณควรโพสต์การบริจาคที่ได้รับก่อนหน้านี้เป็นการบริจาคภายนอก ซึ่งรวมถึงการบริจาคใดก็ตามที่เคยได้รับบน Facebook ด้วย วิธีนี้จะช่วยรับรองว่าจำนวนเงินที่ระดมทุนไว้ทั้งหมดตรงกับที่แสดงในเว็บไซต์ของคุณ
ถาม: เราควรจะรับมือกับกรณีที่ผู้ใช้ออกจากงานกิจกรรมหรือย้ายไปยังงานกิจกรรมใหม่อย่างไรตอบ: คุณสามารถเลือกได้ว่าคุณต้องการจะยุติโครงการระดมทุนบน Facebook ในกรณีเหล่านี้หรือไม่ สำหรับการย้ายผู้เข้าร่วม คุณสามารถอัพเดตวันที่สิ้นสุดได้ผ่าน API เพื่อให้แน่ใจว่าโครงการระดมทุนบน Facebook จะสิ้นสุดลงอย่างสอดคล้องกับวันที่จัดงานกิจกรรมใหม่
การบริจาคบน Facebook
ถาม: ใครสามารถร่วมบริจาคเงินหรือสร้างโครงการระดมทุนบน Facebook ได้บ้างตอบ: เรารองรับการบริจาคจากประเทศในรายชื่อที่คัดเลือกไว้ คุณสามารถดูรายชื่อประเทศทั้งหมดได้ที่นี่: https://facebook.com/help/837523116348786 ผู้ที่ไม่สามารถบริจาคได้จะเห็นปุ่มบริจาคเป็นสีเทา
ถาม: ทำไมผู้บริจาคจึงเห็นข้อความแสดงข้อผิดพลาดเมื่อพยายามบริจาคเงินตอบ: ปัญหาอาจอยู่ที่บัตรที่ผู้บริจาคพยายามที่จะใช้ ลองลบแล้วเพิ่มบัตรเข้าไปใหม่จากการตั้งค่าการชำระเงิน: https://secure.facebook.com/settings?tab=payments§ion=settings
ถาม: ฉันจะเข้าถึงรายงานธุรกรรมที่แสดงยอดบริจาคที่ได้รับบน Facebook ได้อย่างไรตอบ: คุณสามารถดาวน์โหลดรายงานธุรกรรมได้จากเพจขององค์กร คุณสามารถดูข้อมูลเพิ่มเติมได้ที่นี่: https://facebook.com/help/1787615158233986
ถาม: ฉันจะเรียกดูข้อมูลผู้บริจาคผ่าน Webhook ได้หรือไม่ตอบ: Webhook ไม่มีข้อมูลผู้บริจาค แต่มี ID การชำระเงินซึ่งคุณสามารถนำไปจับคู่กับ ID ที่พบในรายงานธุรกรรมได้
การคืนยอดบริจาค
ถาม: โครงการระดมทุนจะอัพเดตข้อมูลหรือไม่เมื่อออกยอดเงินคืนแล้วตอบ: ในขณะนี้ เมื่อคืนยอดบริจาคแล้ว โครงการระดมทุนบน Facebook จะไม่แสดงการคืนเงินดังกล่าว และยอดเงินที่ระดมทุนได้ทั้งหมดจะยังคงเหมือนเดิม ระบบจะไม่ส่งเหตุการณ์ Webhook เพื่อแจ้งให้คุณทราบถึงการคืนเงิน
ถาม: ฉันควรจัดการการคืนเงินบนเว็บไซต์ขององค์กรไม่แสวงผลกำไรอย่างไรตอบ: หากมีคนบริจาคเงินบนเว็บไซต์ของคุณและขอเงินคืนในภายหลัง คุณก็ควรอัพเดตยอดบริจาคใน Facebook ให้ตรงกันด้วย หากขอเงินคืนเต็มจำนวน คุณก็สามารถลบการบริจาคภายนอกที่คุณโพสต์ไว้ก่อนหน้านี้ออกไปได้เลย แต่หากขอเงินคืนเพียงบางส่วน คุณก็สามารถลบการบริจาคภายนอกแล้วโพสต์การบริจาครายการใหม่โดยแก้ไขยอดเงินแทนได้