המדריך הזה מיועד למפתח האתר שלכם. הוא מסביר איך לשלוח (POST) פרטי תורם ותשלום מהאתר שלכם אל טופס התרומה שלנו.

יש שלוש דרכים לסלוק תשלומים דרכנו:

הדרך הפשוטה: צרו טופס MYSITE והתקינו אותו כ-iframe באתר שלכם. ראו יצירת טופס תרומה MYSITE ו-טופס תרומה — מדריך הטמעה.

כדי לשלב את ה-iframe בפלטפורמה או באפליקציה שלכם:

שלחו את נתוני ה-POST לכתובת הזו:

https://<secure-donation-domain>/en/give/makedonation?MakeDonation=1&AmutaGovId=XXXXXX&fb=1&successurl=https://example.com/thank-you

אם בניתם את האינטגרציה לפני שהטפסים עברו ל-/give/, ייתכן שכתובת /pay/ או /donate/ עדיין עובדת. אנחנו ממליצים לעבור ל-/give/.

החליפו את /en בכתובת באחד מאלה:

כברירת מחדל, ה-iframe מציג רק את שדות כרטיס האשראי. הוא מציג גם כל שדה חובה שלא שלחתם: מטבע, תדירות, סכום, מייל או שם.

כדי להציג שדות נוספים בכל זאת, שלחו ב-POST פרמטר showcontrols עם רשימה מופרדת בפסיקים:

לדוגמה: showcontrols=currency,frequency.

כן. הוסיפו שדות מותאמים לכתובת (query string), עד 10 שדות, כך: CF1=xxxxx&CF2=yyyyy.

הוסיפו משתנים ל-successurl. אחרי שהתשלום מאושר, נעביר את התורם לכתובת הזו כשהערכים כבר מולאו:

&successurl=https://example.com/thank-you?tsum={sum}&tcurrency={currency}&tfname={fname}&tlname={lname}&tfrequency={frequency}&ttrid={trid}&tdonid={donid}&inst={installments}

כללים ל-successurl:

לפני שמתחילים לבדוק, שלחו לנו את כתובת המייל וכתובת ה-IP שמהן תבדקו. מערכת ההגנה מהונאות שלנו עלולה לחסום תרומות חוזרות מאותו מייל או IP. נוסיף אתכם לרשימת הכתובות הבטוחות.

צריכים גישה לחשבון עמותה לדוגמה? פנו לתמיכה.

לדף שמדגים איך פרמטרים שונים משנים את ה-iframe, פנו לתמיכה.