שימוש ב - תבניות שונות

קיימות 2 גירסאות שונות של טופס המייסייט: donate (משנת 2015) ו- pay (משנת 2020).

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

כך שאם כתובת טופס התרומה הנוכחית שלכם היא:

https://secured.israelgives.org/he/donate/leket2

תוכלו לשנות אותה ל:

https://secured.israelgives.org/he/pay/leket2

שינוי ה - URL

כברירת מחדל, טופס התרומה יושב בדומיין secured.israelgives.org עבור טופס באנגלית, וב - secured.israeltoremet.org עבור טופס בעברית.

עם זאת, תוכלו להשתמש בדומיין secureddonation.com במקום כל אחד מהדומיינים הללו.

כך שאם ה - URL שלכם כרגע הוא https://secured.israelgives.org/he/pay/leket2

תוכלו לשנותו ל - https://secureddonation.com/he/pay/leket2

העברת משתנים לטופס התרומה (POST)

תוכלו לכלול מספר משתנים בכתובת האינטרנט (ה-URL) של טופס התרומה שלכם (או באמצעות שיטת POST), על מנת לבחור מראש אפשרויות מסוימות שיופיעו בטופס התרומה.

ניתן להוסיף משתנים על גבי טופס תרומה MYSITE או על גבי טופס שאינו מותאם אישית.

הקישור (URL) של MYSITE נראה כך: https://secureddonation.com/he/pay/leket2

הקישור של טופס שאינו מותאם אישית נראה כך: https://secureddonation.com/he/pay/makedonation?MakeDonation=1&AmutaGovId=580484681

שימו לב כי תוכלו להחליף את משתנה השפה (en/) כפי שתרצו, ואם אתם משתמשים בטופס שאינו מותאם אישית, הקפידו להחליף את 580484681 עם מספר העמותה שעבורה תרצו לסלוק תשלום. לאחר כתובת ה- URL הבסיסית שלכם, תצטרכו להוסיף סימן שאלה (?). לאחר מכן תוכלו לכלול מספר משתנים שיכללו בטופס התרומה:

  • currency ( מטבע)

  • sum (סכום)

  • freq (תדירות)

  • step=2 (לטעון את הטופס ישירות בשלב 2 של תהליך התרומה)

  • noemailreq=1 (כתובת דוא"ל לא חובה)

  • cf1=XXXX (שדה מותאם אישית)

  • fb=1 (להציג רק את החלק האמצעי של הטופס)

  • cc911=1 (לבצע תרומה עם כרטיס דמו)

אם תרצו להשתמש ביותר ממשתנה אחד, הוסיפו את הסימן & בין המשתנים השונים, כך:

?currency=1&sum=100&freq=2


Currency (מטבע)
משתנה זה מסמן את המטבע ומספר הזיהוי שלו שתרצו לבחור. לצפייה ברשימת המטבעות המלאה ומספרי הזיהוי שלהם, לחצו כאן .

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

https://secureddonation.com/en/pay/leket2?currency=2


Sum (סכומי התרומה)

די מסביר את עצמו. הזינו את המשתנה sum= ואז את הסכום שתרצו שיכלל מראש. שימו לב שאם הסכום שתציינו הוא אחד מסכומי התרומה המוצעים בטופס, אז זהו סכום שיופיע כבר מראש. אם הסכום שתבחרו הוא לא אחד מסכומי התרומה מוצעים, אז הוא יופיע בסכום התרומה ה"אחר" שהמשתמש יכול להזין.

אז אם תרצו לבחור מראש דולר אמריקאי ו - 100, השתמשו בפורמט הזה:
https://secureddonation.com/en/pay/leket2?currency=2&sum=100

Frequency ( תדירות התרומה)

תוכלו לבחור מבין 3 תדירויות: תרומה חד-פעמית (1), תרומה חודשית (2) ותרומה שנתית, בפורמט הבא (השתמשו ב - freq):
https://secureddonation.com/en/pay/leket2?currency=2&sum=100&freq=2

תוכלו להשתמש גם במשתנים הבאים

  • projectId: זהו המספר המזהה של הפרויקט שנוצר דרך חשבון העמותה.

  • noemailreq=1:הוספה של משתנה זה תגרום לכתובת האימייל להיות שדה אופציונלי בטופס התרומה שלך (בלעדיו, כתובת אימייל בלעדיו כתובת אימייל כתובת אימייל תמיד תהיה שדה נדרש).

  • spaff: זהו משתנה שטוב לשימוש למטרת מעקב ותיעוד מקור המפנה לטופס התרומה שלך, כמו מקור פרסומי לדוגמא. הוא צריך להיות בנוי ממילה אחד, ללא רווחים או סמלים מיוחדים חות מאשר "-" או "_".

כך שאם תרצו להוסיף משתנה spaff שנקרא walla_news, זה צריך להופיע כך:

https://secureddonation.com/en/pay/leket2?currency=2&sum=100&freq=2&spaff=walla_news

שלב 2

אם אתם מעבירים סכום, תדיגות ומטבע אל טופס התרומה, באפשרותכם לדלג ישירות אל שלב התשלום (שאנו קוראים לו " שלב 2") של טופס התרומה. פשוט הוסיפו step=2 על גבי ה-URL, כך:

https://secureddonation.com/en/pay/leket2?currency=2&sum=100&freq=2&spaff=walla_news&step=2

  • Note that when you skip ahead to Step 2, we'll automatically place the

  • שימו לב שכאשר אתם מדלגים ישירות אל שלב 2, נמקם באופן אוטומטי את כתובת האימייל שמולאה בשדה המיועד בשלב זה של תהליך התרומה, בניגוד למיקומה המקורי בשלב 1.

  • שימו לב שכשתשתמשו ב XX , התורם ידרש לשלם באמצעות כרטיס אשראי (פייפאל יכול להבחר כאמצעי תשלום רק משלב 1).

מעקב לפי שדות בהתאמה אישית (Custom field)

בכתובת עמוד של כל טופס התרומה, בסוף ה-URL, תוכלו להוסיף קטע ייחוס (attribution), שנראה כך: ?cf1=XXXX , כאשר במקום XXXX תזינו מילה אחת בתווים לטיניים.

כך שאם טופס התרומה שלכם ממוקם בכתובת https://securedddonation.com/donate/charity , הכתובת החדשה כולל המעקב תהיה https://securedddonation.com/donate/charity?cf1=XXXX

האותיות CF מייצגות "שדה בהתאמה אישית" (custom field), והן ייתנו ייחוס לכל תרומה שנעשתה דרך קישור ה -URL שמכיל את הסיומת הזו. תוכלו לראות זאת כאשר תייצאו את דו"ח התרומות שלכם לאקסל דרך חשבונכם..

אנו תומכים ב- 20 שדות מותאמים אישית, כך שתוכלו להוסיף עד 20 שדות מעקב, על ידי הוספת החלק הבא ל-URL:

cf1=XXX&cf2=XXXX&cf3=XXXX (etc..)

חלק מרכזי בלבד

אם ברצונכם להציג את החלק המרכזי בלבד (בלי הצדדים הימני והשמאלי של העמד), הוסיפו fb=1 על גבי ה - URL.

בדיקות וטסטים עם כרטיס הדמו שלנו

אם אתם רוצים לבדוק את טופס התרומה מבלי לבצע תרומה אמיתית, הוסיפו cc911=1 על גבי ה- URL ואז השתמשו בכרטיס האשראי שמספרו: 9111111111111111.

הסתרת שדות בטופס התרומה (נוסף ב 28/07/2020)

אתם יכולים להסתיר מספר שדות בטופס התרומה על ידי הוספת אחד או יותר מהמשתנים הבאים לכתובת ה- URL של הטופס שלכם:

• hidefrequency = 1 יסתיר את לשונית תדירות התרומה בראש העמוד. הקפד להעביר את התדירות (freq) לכתובת ה- URL, עם זאת, אחרת הטופס לא יתפקד כראוי.

• hidetaxstatus = 1 יסתיר את סעיף הסטטוס לניכוי מס.

• hidecurrency = 1 יסתיר את בורר התפריט (מטבע). עם זאת, הקפד להעביר את המטבע לכתובת URL, אחרת הטופס לא יתפקד כראוי.

• hidehonoreecard = 1 יסתיר את היכולת ליצור כרטיס אלקטרוני של honoree.

• hidepaypal = 1 יסתיר את אפשרות התשלום באמצעות PayPal

• hideaddress = 1 יסתיר את שדה הכתובות האופציונלי. שים לב שהכתובת נדרשת בתרומה בדולרים קנדיים, כך שהכתובת תופיע גם אם אתה משתמש במשתנה זה.

• hidhone = 1 יסתיר את מספר הטלפון.

• hidelanguage = 1 יסתיר את בורר השפות בראש העמוד.

כך, למשל, אם רציתם להשתמש בכל המשתנים הללו, כתובת האתר שלכם יכולה להיות:

https://secureddonation.com/en/pay/MoreshetFund?hidecurrency=1&currency=2&hideaddress=1&hidephone=1&hidefrequency=1&freq=2&hidepaypal=1&hidetaxstatus=1&hidehonoreecard=1

הפנייה לכתובת אחרת לאחר תשלום

כברירת מחדל, לאחר תשלום מוצלח, אנו מפנים את המשתמש לדף "תודה" שלנו.

אם אתם רוצים להפנות את הקישור לדף התודה שלכם (הנמצא בכתובת https://www.my.org/thankyou ), השתמש בפרמטר successurl כך:

https://secureddonation.com/en/pay/MoreshetFund?successurl=https://www.my.org/thankyou

כיצד לטעון את דף התודה בדף אינטרנט אחר ולא במודל

אם אתם טוענים את טופס התרומה כמודל ורוצים להפנות את התורם לאחר תשלום מוצלח לכתובת האתר שלכם, אך בתוך דף האב (ולא בתוך המודל), השתמש ב- pptop = 1

להחזיר לעצמך את פרטי התשלום

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

&successurl=http://xxxx.com?tsum={sum}&tcurrency={currency}&tfname={fname}

&tlname={lname}&tfrequency={frequency}&ttrid={trid}&tdonid={donid}
&inst={installments}

  • סכום = סכום תשלום

  • מטבע: אנו נחזיר את המטבע כראשי תיבות של 3 אותיות (למשל דולר ארה"ב יהיה USD )

  • Fname = שם פרטי

  • Lname = שם משפחה

  • תדירות = נחזיר לך 1 (תרומה חד פעמית), 2 (תרומה חודשית חוזרת) או 3 (תרומה שנתית חוזרת)

  • Donid = מספר התרומה כפי שנרשמה במערכת שלנו

  • תשלומים - מספר התשלומים שהתורם בחר, או 0 אם אין

שימו לב שלאחר הפרמטר successurl בא הסימן ? , וכי כל הפרמטרים מופרדים עם &

  • אנו ממליצים שכל מה שבא לאחר successurl יעשה ב urlencode.

  • הקפידו למקם את successurl כפרמטר האחרון שאתם מציבים בכתובת האתר

האם מצאת את התשובה שלך?