התחברות למנוע סליקה כללי

אלחנן1

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

ערך חובה בכל אחת מחברות הסליקה:

type=credit_card

קישורים לתוספים שניתנים להגדרה בכל מודול

רשימת כל ההגדרות שניתנות להטמעה בכל מודול

הגדרות זיהוי בכניסה לשלוחה

הסבר על הודעת ברוכים הבאים (הודעה ראשונה בשלוחה)

הרשאות כניסה לשלוחה

הגדרות כלליות התקפות בכל חברות הסליקה

להלן רשימת החברות שיכולות לסלוק דרכינו:

טרנזילה

CreditGuard קרדיט גארד

הוראת קבע (נדרים פלוס ופלאקארד וקשר קהילות)

תפיסת מסגרת במקום חיוב מידי (טרנזילה וקארדקום)

הודעות ודוחות הקשורים למודול

טרנזילה

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

credit_card_type=tranzila

שם המשתמש שקיבלתם מטרנזילה

credit_card_user_name=כאן יש לרשום את שם המשתמש שלכם

סיסמת PW שקיבלתם מטרנזילה

credit_card_password=כאן יש לרשום את הסיסמה שקיבלתם מטרנזילה

את הסיסמה אנחנו שולחים לטרנזילה בערך שנקרא TranzilaPW

ערכים נוספים לא חובה

תיאור המוצר
ברירת מחדל התיאור הוא שם התיקיה, באם הערך מלא המערכת מתחשבת בו. תאור המוצר נשמר בערך pdesc של טרנזילה.

credit_card_register_number=כאן יש לרשום את תיאור המוצר

הערות

credit_card_remarks=כאן יש לרשום את ההערה

כתובת למשלוח אימייל מטעם טרנזילה עם החשבונית וכד'
ברירת מחדל נשלח לאימייל המוגדר בחייגן או כפי שמוגדר בערך

email_address=

ניתן להגדיר לשלוח לכל לקוח היישר לאימייל שלו על ידי הגדרת האימייל בטבלה של כניסה אישית לפי list all information
יש להגדיר את כל הערכים של כניסה לפי זיהוי אישי (ראה כאן) ובנוסף להגדיר

credit_card_email=from_list_all_information

בערך company של טרנזילה ברירת מחדל נשלח

Yemot-מספר מערכת-מספר זיהוי אם קיים-שם הזיהוי אם קיים-מוסד הזיהוי אם קיים

אם רוצים שישלח לערך company בטרניזלה את השם
ולערך contact את המספר האישי
ולערך address את שם בית הספר (עמודה 6 ב list_all_information)
ולערך city את שם העיר (עמודה 14ב list_all_information)

יש להגדיר את הערכים לזיהוי אישי לפי המופיע בכניסה מסוג list_all_information ובנוסף

credit_card_company=id_and_name_and_school

יצירת טוקן token לחיוב או זיכוי עתידי
(כרגע פעיל רק מול חברת טרנזילה)

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

credit_card_create_token=yes

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

קרדיט_גארד

CreditGuard - קרדיט גארד

credit_card_type=credit_guard

שם משתמש

credit_card_user_name=כאן יש לרשום את שם המשתמש

סיסמה

credit_card_password=כאן יש לרשום את הסיסמה

מספר טרמינל

credit_card_terminal_number=כאן יש לרשום את מספר הטרמינל

כתובת שרת
השרת שמוגדר בברירת מחדל הוא cgpay6. יש לבדוק מול החברה על איזה שרת (server) הם מקימים את המסוף ולעדכן בערך הבא:

credit_card_url=כאן יש לרשום את שם השרת

הערות - ערך לא חובה
ניתן עד 15 תווים אחרת העסקה תכשל

credit_card_remarks=כאן יש לרשום את ההערות

קשר_קהילות

קשר - קהילות - הוראות קבע

שימו לב שהשם משתמש והסיסמה זה לא מה שיש לצפייה באתר, אלא לסליקה דרך האינטרנט. במידת הצורך בקשו זאת מקשר.

credit_card_type=kesherhk

שם משתמש

credit_card_terminal_number=כאן יש לרשום את שם המשתמש

סיסמה

credit_card_password=כאן יש לרשום את הסיסמה

מספר חנות / מספר פרויקט - ערך זה הינו ערך חובה ללקוחות קשר

credit_card_register_number=כאן יש לרשום את מספר החנות / פרוייקט

הערות - ערך לא חובה
ישלח לקשר קהילות על ערך שלהם בשם addData
הערך יכול להיות ספרות בלבד ומקסימום 8 ספרות

credit_card_remarks=כאן יש לרשום את ההערות

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

credit_card_comment=כאן יש לרשום את הערך לחשבונית

כתובת למשלוח אימייל מטעם קשר קהילות עם החשבונית וכד' (יש לסגור זאת מול קשר קהילות, מבחינת ימות המשיח זה נשלח על ערך שלהם בשם mail)
ברירת מחדל נשלח לאימייל המוגדר בחייגן או כפי שמוגדר בערך

email_address=

ניתן להגדיר לשלוח לכל לקוח היישר לאימייל שלו על ידי הגדרת האימייל בטבלה של כניסה אישית לפי list all information
יש להגדיר את כל הערכים של כניסה לפי זיהוי אישי (ראה כאן) ובנוסף להגדיר

credit_card_email=from_list_all_information

בערך name של קשר קהילות אנחנו שולחים את השם של הלקוח
ובערך addData אנחנו שולחים את ה-ID שאיתו הלקוח נכנס (ספרות בלבד ללא סוג הזיהוי כגון טלפון או תעודת זהות וכדומה)

עדיין לא פעיל עקב בעיות בהגדרות מול קשר, יתוקן ויעודכן

מספר זיהוי אם קיים - שם הזיהוי אם קיים - מוסד הזיהוי אם קיים
אם רוצים שישלח בעברית
שם: .. זיהוי: .. מוסד..
יש להגדיר את הערכים לזיהוי אישי לפי המופיע בכניסה מסוג list_all_information ובנוסף
ובנוסף להגדיר

credit_card_name=id_and_name_and_school

נדרים_פלוס

נדרים פלוס

credit_card_type=nedarim_plus
credit_card_terminal_number=כאן יש לרשום את מספר המוסד שקיבלתם מנדרים פלוס

במידה ואתם רוצים שיוכלו לשמור טוקנים לעסקאות עתידיות יש להגדיר גם את ה ApiValid (ניתן לקבל בשירות הלקוחות של נדרים פלוס)

nedarim_plus_ApiValid=j%2biyEFN3bE

(זאת בנוסף להגדרה של הפעלת האפשרות של סליקה באמצעות טוקן

credit_card_create_token=yes

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

credit_card_category_nedarim_plus=כאן יש לרשום את שם הקטגורייה

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

במקרה שלקוח בוחר את הזיהוי הטלפוני
אז המערכת תשדר בנפרד את הטלפון שממנו הלקוח חייג,
הערך ישודר בתוך הערך Avour ושם יופיע

OriginalPhone-0771234567

להגדרה שהמערכת תפעיל את התפריט
M1589 "לשידור מספר הטלפון ממנו התקשרתם הקישו 1 וסולמית לשידור מספר טלפון אחר הקישו את מספר הטלפון וסולמית לסיום"
הגדירו:

credit_card_enter_phone=yes

הערך הזה בנתיים פעיל רק בנדרים פלוס, במידת הצורך בקשו משרות הלקוחות שנוסיף שאלה זו בחברות סליקה נוספות.

לפירוט שליחת שם וכתובת, לחצו כאן

הערה בשליחת כתובת:
במקרה ומדובר על סליקה רגילה - DebitCard הערך ישודר בAdresse
(ברירת מחדל ערך Adresse הינו ערך ריק)
במידה ומדובר על הוראת קבע - DebitKeva הערך ישודר בStreet
(ברירת מחדל ערך Street הינו ערך ריק)

קארדקום

credit_card_type=cardcom

שם משתמש

credit_card_user_name=כאן יש לרשום את שם המשתמש שקבילתם מקארדקום

מספר טרמינל

credit_card_terminal_number=כאן יש לרשום את מספר הטרמינל שקיבלתם מקארדקום

מספר חנות

credit_card_register_number=כאן יש לרשום את מספר החנות

ברירת מחדל אם לא מסומן מספר חנות, זה 555

בברירת מחדל המייל שמופיע בחשבונית הוא המייל שמופיע בהגדרות משתמש.
ניתן להגדיר כתובת מייל שונה. ההגדרה היא:

cardcom_email=כאן יש לרשום את כתובת המייל או הכיתוב שיופיע

בברירת מחדל שם המוצר שמופיע בחשבונית הוא 'מערכת 077******* yemot'.
ניתן להגדיר שיופיע תיאור מוצר אחר. ההגדרה היא:

cardcom_description=כאן יש לרשום את תיאור המוצר הרצוי

יצירת חשבוניות בקארדקום
ראשית כל חובה לוודא אצל קארדקום שהמסוף שלכם תומך בהנפקת חשבוניות
לאחר מכן יש להגדיר

credit_card_create_invoice=yes

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

ברירת מחדל נשלח לאימייל המוגדר בחייגן או כפי שמוגדר בערך

email_address=

ניתן להגדיר לשלוח לכל לקוח היישר לאימייל שלו על ידי הגדרת האימייל בטבלה של כניסה אישית לפי list all information
יש להגדיר את כל הערכים של כניסה לפי זיהוי אישי (ראה כאן) ובנוסף להגדיר

credit_card_email=from_list_all_information

במידה ויש אימייל מוגדר זה ישלח לשם
במידה ואין אימייל מוגדר זה ישלח לאימייל של המערכת.

שידור העיסקה לתוך מחלקה בתוך החשבון שלכם בקארדקום
הערך שמשודר לקארדקום הוא invdepartmentid
ההגדרה אצלנו היא

credit_card_cardcom_invde_partment_id=3

בדוגמא כאן מה שישודר לקארדקום יהיה

&invdepartmentid=3

פלאקארד

credit_card_type=pelecard

שם משתמש

credit_card_user_name=כאן יש לרשום את שם המשתמש שקבילתם מפלאקארד

סיסמה

credit_card_password=כאן יש לרשום את הסיסמה שקיבלתם מפלאקארד

מספר טרמינל

credit_card_terminal_number=כאן יש לרשום את מספר הטרמינל שקיבלתם מפלאקארד

מספר חנות

credit_card_register_number=כאן יש לרשום את מספר החנות

אם לא מסומן ברירת מחדל זה 555

סוג סליקה בפלאקארד
תשלומים / קרדיט / תשלום אחד

האפשרויות הקיימות הן:

credit_card_pelecard_type=DebitRegularType
credit_card_pelecard_type=DebitPaymntsType
credit_card_pelecard_type=DebitCreditType

ברירת מחדל כאילו מוגדר DebitRegularType. אם אתם מגדירים תשלומים, חובה לשנות ערך זה ולבחור DebitPaymntsType עבור עסקת תשלומים רגילה, או DebitCreditType עבור עסקת תשלומים של קרדיט.

הערה חשובה - במצב שבו אתם מאפשרים מעל תשלום אחד ואתם משתמשים אפשרויות התשלומים / קרדיט, והלקוח בחר תשלום אחד, אנחנו שולחים לפלאקארד ערך DebitRegularType ולא משנה מה הגדרתם, (מכיון שפלאקארד לא תומכים בפונקציית תשלומים בתשלום אחד)

פלאקארד-הוראת קבע / תשלומים בהוראת קבע

במידה והגדרתם סליקה באמצעות הוראת קבע או תשלומים בהוראת קבע, אין צורך להגדיר את סוג הסליקה, זה נשלח בכל מקרה לפלאקארד בפונקציות של WsPeleBillingCustomers ליצירת לקוח וכן WsPeleBillingDirectDebits לחיוב תשלומים
להגדרת הוראת קבע הגדירו

credit_card_payment_type=keva

לתשלומים בהוראת קבע הגדירו

credit_card_payment_type=tashloumim_keva

להסבר מפורט על הוראת קבע ותשלומים בהוראת קבע לחצו כאן.

חיוב אוטומטי או ידני של הוראת הקבע

ברירת מחדל החיוב מתבצע על ידי פלאקארד בצורה אוטומטית כל חודש, ניתן להגדיר

credit_card_pelecard_debits_direct_auto_charge=no

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

credit_card_remarks=הערות לסליקה

הערך ישלח כחלק מערך פלאקארד בשם paramx
הערך מכיל מספר טלפון וכן זמן (שעה ודקה) של הסליקה,
בנוסף לזה יתווסף הערה שהוספתם

credit_card_pelecard_description=Folder

בחברת פלאקארד, הערך ישלח כחלק מערך פלאקארד בשם paramx
הערך כבר מכיל מספר טלפון וכן זמן (שעה ודקה) של הסליקה,
בנוסף לזה יתווסף "שלוחה XX" מיקום השלוחה שאתם נמצאים
כמו כן ניתן לרשום הערה חופשית לדוגמא:

credit_card_pelecard_description=ABC770

במקרה כזה בחברת פלאקארד, הערך ישלח כחלק מערך פלאקארד בשם paramx
הערך כבר מכיל מספר טלפון וכן זמן (שעה ודקה) של הסליקה,
בנוסף לזה יתווסף ABC770 לערך.

שימו לב הגדרת credit_card_pelecard_description גוברת על הגדרת credit_card_remarks
כך שאם הגדרתם את שתיהם, המערכת תתיחס רק ל credit_card_pelecard_description

עסקים

סליקת חברת עסקים

ערכי חובה הן - מספר מסוף ומספר ארגון וטוקן

credit_card_type=asakim

מספר מסוף

credit_card_terminal_number=כאן יש לרשום את מספר המסוף שקבלתם מעסקים

מספר ארגון

credit_card_user_name=כאן יש לרשום את מספר ה-WorkingCompany שקיבלתם מעסקים

טוקן

credit_card_terminal_token=כאן יש לרשום את מספר טוקן מסוף שקיבלתם מעסקים

ריווחית

'ריווחית' - iCredit

credit_card_type=icredit

טוקן

credit_card_user_name=כאן יש לרשום את מספר הטוקן של המסוף שלכם שקבלתם מריווחית

תיאור המוצר
ברירת מחדל לא נשלח תיאור מוצר. באם רוצים לשלוח, יש להגדיר:

credit_card_icredit_Description=כאן יש לרשום את תיאור המוצר

הערות

credit_card_remarks=כאן יש לרשום את ההערה

כתובת למשלוח אימייל מטעם חברת האשראי כולל חשבונית וכד'
ברירת מחדל נשלח לאימייל המוגדר בחייגן או כפי שמוגדר בערך

email_address=

ניתן להגדיר לשלוח לכל לקוח היישר לאימייל שלו על ידי הגדרת האימייל בטבלה של כניסה אישית לפי list all information
יש להגדיר את כל הערכים של כניסה לפי זיהוי אישי (ראה כאן) ובנוסף להגדיר

credit_card_email=from_list_all_information

טלפון מחייג נשלח כברירת מחדל.
עיר בה גר הלקוח, נשלח כברירת מחדל מעמודה 14 עם כניסה אישית לפי list all information
לפירוט שליחת שם וכתובת, לחצו כאן

להלן ערכים נוספים לשליחה:

מספר כרטיס לקוח

credit_card_icredit_CustomerId=כאן יש לרשום מספר כרטיס לקוח

מספר קטלוגי בריווחית

credit_card_icredit_CatalogNumber=כאן יש לרשום מספר קטלוגי בריווחית

קוד פרוייקט בריווחית

credit_card_icredit_ProjectId=כאן יש לרשום קוד פרוייקט בריווחית

שליחת מייל מריווחית לדוא"ל נסתר כולל חשבונית

credit_card_icredit_EmailBcc=aaa@gmail.com

מס' סוכן בריווחית

credit_card_icredit_AgentId=כאן יש לרשום מס' סוכן בריווחית

שפת מסמך
כדי שהחשבונית תהיה בשפת אנגלית, יש להגדיר:

credit_card_icredit_DocumentLanguage=en

סוג עסקה
1 = עסקה מיידית.
2 = עסקה בממתינה.
3 = איסוף כרטיס בלבד
כברירת מחדל, נשלח מצב 'עסקה מידית' כך:

credit_card_icredit_SaleType=1

יעד_שריג

יעד שריג

credit_card_type=yaad_pay

מספר מסוף (ביעד שריג)

credit_card_terminal_number=כאן יש לרשום את מספר המסוף

קוד מסוף לסליקה passP (שימו לב שלא מדובר בטוקן)

credit_card_password=שהגדרתם passP כאן יש לרשום את

הסבר ליצירת passP למסוף שלכם

ב"הוספת פרמטר" תוכלו להגדיר passP

איי_קאונט

איי קאונט iCount

קודם יש להגדיר את סוג הסליקה

credit_card_type=icount

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

credit_card_user_name=user_name

סיסמה

credit_card_password=128976

מזהה חברה

credit_card_terminal_number=iCount

שמחה - זו הסיסמא

הגדרות כלליות בכל הסליקות

הקלטה לפני הסליקה

ניתן להגדיר שלפני תחילת הסליקה הלקוח יקליט הודעה שתשלח אליכם במידה והעיסקה תבוצע בהצלחה
יש להגדיר

credit_card_record=yes

בנוסף אם רוצים שלאחר ההקלטה ידלג על "לשמיעת ההקלטה, לאישור, להקלטה מחודשת" אלא מיד ימשיך הלאה כאלו הלקוח אישר
ניתן להגדיר

credit_card_record_ok=#

ההקלטות הקשורות להקלטת הודעה
M1691 לאחר הצליל אנא הקליטו את ההודעה למנהל המערכת, ההודעה תשלח במידה והעיסקה תבוצע בהצלחה, בסיום ההקלטה הקישו סולמית
M1553 לאישור ההקלטה הקישו 1 לשמיעה הקישו 2 להקלטה מחדש 3
M1554 הפרטים נקלטו בהצלחה

שליחת_שם

שליחת שם לחברת האשראי

כברירת מחדל, השם שנשלח הוא השם המופיע ב ID.
באם אין שם ומוגדר הקלטת שם מהלקוח, השם שישלח הוא השם שהוקלט.

המרת ההקלטה לטקסט כרוכה ביחידות.
לפרטים ולמחירון לחץ כאן

כדי שיבקש הקלטת שם מהלקוח, יש להגדיר:

credit_card_name_stt=yes

במידה והגדרתם המערכת תשמיע
M1983 לצורך שידור לחברת הסליקה אנא הקליטו את השם של בעל הכרטיס וסולמית לסיום

במידה וההקלטה פחות משניה וחצי
המערכת תודיע
M1305 ההודעה קצרה מידי
ותקליט מחדש

לאחר ההקלטה המערכת תשמיע את השם שנקלט בטקסט והמרתו חזרה לקובץ קולי
ומיד לאחר מכן תפריט
M1553 לאישור ההקלטה הקישו 1 לשמיעה הקישו 2 להקלטה מחדש 3

אם ברצונכם שהמערכת לא תשמיע את השם שנקלט, ובמידה ויש תוצאה שהתקבלה בשם מיד להתקדם ללא בקשת אישור
יש להגדיר

credit_card_name_stt_record_no_ask=yes

אם ברצונכם לעזור להבנת התשובה
ניתן לתת תשובות לעזרה בתרגום הקובץ הקולי, את הקובץ יש לשים בשלוחה הראשית
קובץ בשם

CreditCardName.ini

בין שם לשם לעשות אנטר
ולשמור על utf-8

ברירת מחדל התוצאה של השמות היא בעברית.

lang=he-IL

ניתן לשנות את השפה של התשובה לשפות נוספות

לבירור שפות נוספות לחצו כאן

שליחת_כתובת

שליחת כתובת לחברת האשראי

במידה וברצונכם לשדר את הכתובת של הלקוח שיצורף לחשבונית מתוך קובץ list_all_information יש להגדיר

credit_card_create_invoice=yes

במקרה כזה נשדר בערך לנדרים פלוס את EnterID וכן את ערך המוסד (School) מתוך טבלת list_all_information

הקלטת כתובת

המרת ההקלטה לטקסט כרוכה ביחידות.
לפרטים ולמחירון לחץ כאן

שימו לב: הגדרה זו גוברת על ההגדרה הקודמת

כדי שיבקש הקלטת כתובת מהלקוח, יש להגדיר:

credit_card_adresse_stt=yes

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

במידה וההקלטה פחות משניה וחצי
המערכת תודיע
M1305 ההודעה קצרה מידי
ותקליט מחדש

לאחר ההקלטה המערכת תשמיע את השם שנקלט בטקסט והמרתו חזרה לקובץ קולי
ומיד לאחר מכן תפריט
M1553 לאישור ההקלטה הקישו 1 לשמיעה הקישו 2 להקלטה מחדש 3

אם ברצונכם שהמערכת לא תשמיע את השם שנקלט, ובמידה ויש תוצאה שהתקבלה בשם מיד להתקדם ללא בקשת אישור
יש להגדיר

credit_card_adresse_stt_record_no_ask=yes

אם ברצונכם לעזור להבנת התשובה
ניתן לתת תשובות לעזרה בתרגום הקובץ הקולי, את הקובץ יש לשים בשלוחה הראשית
קובץ בשם

CreditCardAdresse.ini

בין שם לשם לעשות אנטר
ולשמור על utf-8

ברירת מחדל התוצאה של השמות היא בעברית.

lang=he-IL

ניתן לשנות את השפה של התשובה לשפות נוספות

לבירור שפות נוספות לחצו כאן

מטבע לחיוב

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

credit_card_currency=2

סכום לחיוב

כברירת מחדל, המשתמש בוחר את הסכום לתשלום.
ניתן להגביל את הסכום אותו המשתמש יוכל לבחור

הגדרת סכום מינימום

credit_card_payment_min=5

בדוגמה, המינימום לתשלום הוא 5

הגדרת סכום מקסימום

credit_card_payment_max=10

בדוגמה, המקסימום לתשלום הוא 10

סכום לחיוב קבוע

ניתן להגדיר סכום קבוע לתשלום
ההגדרה היא

billing_sum=20

בדוגמה, הסכום לתשלום הוא 20.

סכום לחיוב מותאם לכל לקוח

ניתן להגדיר שהסכום לתשלום הינו משתנה בהתאם ללקוח, כמופיע ב enter_id
בכל סוגי ה enter_id,
יש להגדיר במקום הסכום

billing_sum=from_file

בנוסף יש להכניס קובץ BillingSum.ini בשלוחה הנוכחית, שבתוכו יש להכניס לכל זיהוי=סכום

לדוגמה:

0771234567=158

טלפון 0771234567 הסכום לתשלום עבורו זה 158

במידה והכניסה היתה מתוך הקובץ של כל הנתונים למעט סוגי הכניסה ע"פ ListAllInformation שבתקיית EnterID
על ידי שהגדרתם כניסה כאחד מההגדרות

enter_id_type=list_all_information
enter_id_type=phone_from_list_all_information

ניתן להגדיר כנ"ל כמו בכל סוגי הכניסה, אם רוצים שהסכום ילקח מקובץ למעט סוגי הכניסה ע"פ ListAllInformation ניתן להגדיר במקום הסכום

billing_sum=from_list

ואז המערכת תיקח את הסכום מתוך עמודה מוגדרת בקובץ הכללי ListAllInformation.ini

ברירת מחדל יחפש בעמודה מספר 8 בקובץ את הסכום לתשלום

אם ברצונכם שיקח את הסכום לתשלום מעמודה אחרת בקובץ הגדירו

billing_sum_list_all_information_column=10

בדוגמא כאן יקח את הסכום לתשלום מעמודה מספר 10

במידה ואין הגדרה לתשלום עבור אותו לקוח
ברירת מחדל המערכת מודיעה
M2527 לא מוגדר סכום תשלום עבורכם, לא ניתן להמשיך בתשלום, אנא צרו קשר עם מנהל המערכת
והמערכת חוזרת שלב אחד אחורה
ניתן להגדיר

billing_sum_default=menu

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

או ניתן להגדיר סכום כל שהוא

billing_sum_default=77

בדוגמא כאן כל מי שאין שיוך עבורו בקובץ או ברשימה בהתאם להגדרה, אז ישלם סכום של 77

בנוסף ניתן להגדיר שלאחר סליקה בהצלחה הקובץ או העמודה של הסכום יתעדכנו, ובמקום הסכום לתשלום יופיע המילה Done
ברירת מחדל לא מעדכן, אם רוצים שיעדכן יש להגדיר

deal_successfully_billing_sum_mark_done=yes

אחרי עיסקה בהצלחה הוא יסמן שבוצע את הסכום לתשלום
בקובץ או בעמודה במקום הסכום לתשלום יהיה מסומן Done

בפעם הבאה שהלקוח יכנס הוא ישמע
M2528 כבר ביצעתם בהצלחה את התשלום , לא ניתן לשלם שוב.

הערה חשובה: העדכון ל Done אחרי ביצוע סליקה בהצלחה היא רק אם היה נתון לאותו EnterID, במידה ולא היה סכום ל EnterID הזה והגדרתם סכום לתשלום למי שאין הגדרת סכום, המערכת לא תעדכן Done בקובץ או בעמודה, מכיוון שלא הסתמך בסכום לתשלום על המופיע בקובץ

השמעת הסכום לחיוב

ברירת מחדל כאשר הגדרתם סכום לחיוב - המערכת משמיעה את סכום החיוב ואז עוברת לבקשת כרטיס אשראי
M2508 בעיסקה זו תחויבו בסך..
M1420 שקלים
M1829 דולר ארצות הברית"
אם ברצונכם לבטל את השמעת הסכום ניתן להגדיר

billing_sum_say=no

ברירת מחדל, לאחר כל הקשה המערכת משמיעה את מה שהוקש ומשמיעה "לאישור הקישו 1, להקשה מחודשת הקישו 2"
ניתן להגדיר שהמערכת לא תשמיע את מה שהוקש אלא תמשיך הלאה כאילו הלקוח שמע ואישר
עבור מספר כרטיס האשראי יש להגדיר

say_digits_card=no

עבור תוקף הכרטיס יש להגדיר

say_date_card=no

עבור מספר הבטיחות (3 ספרות בגב הכרטיס) יש להגדיר

say_cvv_card=no

עבור תעודת הזהות יש להגדיר

say_id_card=no

עבור מספר התשלומים ישל הגדיר

say_tashloumim=no

ביטול CVV ותעודת זהות

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

credit_card_take_cvv=no

ברירת מחדל בדוחות לא כותב את הcvv שהגיע מהלקוח, אם ברצונכם כי בדוחות הסליקה יופיע ה cvv
(חלק מהלקוחות שמשתמשים אח"כ בזיכוי כרטיס אמרו שצריכים חוץ מ4 ספרות אחרונות גם את הcvv ולכן הוספנו את האפשרות לשמור פרט זה)
יש להגדיר

credit_card_save_cvv=yes

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

credit_card_take_id=no

תשלומים

ברירת מחדל יש תפריט ללקוח לבחירת תשלומים וניתן לבחור עד 36 תשלומים

אם רוצים שהלקוח לא יוכל לבחור פחות מכמות תשלומים מסויים, יש להגדיר

credit_card_min_tashloumim=5

בדוגמה, לא יהיה ניתן לבחור פחות מ 5 תשלומים.

אם רוצים שיהיה רק תשלום אחד יש להגדיר

credit_card_max_tashloumim=1

אם רוצים כמות גדולה מתשלום אחד , אבל כמות מקובעת כלומר חייב לדוגמא 3 תשלומים לא יותר ולא פחות
ניתן להגדיר

credit_card_tashloumim=3

אם רוצים שבכלל לא יהיה איזכור של הנושא של תשלומים, (וכמובן יהיה תשלום 1), ניתן להגדיר

credit_card_tashloumim=no

אם רוצים שיהיה תפריט ללקוח לבחירת כמות התשלומים ולהגדיר מקסימום (בכל מקרה לא ניתן יותר מ36)

credit_card_max_tashloumim=5

בדוגמה, הלקוח יוכל לבחור מ1 עד 5 תשלומים

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

credit_card_number_payments_according_to_minimum_amount_for_single_payment=50

כאן בדוגמה הוגדר שסכום המינימום לכל תשלום הוא 50, ואז במקרה שהלקוח ירצה לתרום לדוגמה 90, מקסימום תשלומים יהיה 1, כי אם הוא יבחר 2 תשלומים, ייצא שכל תשלום הוא 45, וזה פחות ממה שהוגדר, וכן הלאה.
חשוב לציין שכל הגדרות האחרות של תשלומים גוברים על הגדרה זו, (כלומר אם יהיה מוגדר מקסימום תשלומים 2, ולפי ההגדרה הזו יוכל לבחור יותר מ 2, עדיין הוא יוכל לבחור עד 2 תשלומים).

הערה: תשלום בכל מצב לא יכול להיות פחות מ10 ש"ח לכל חלק תשלום

טוקנים - שמירת כרטיסי אשראי לסליקות עתידיות

כרגע פעיל רק בחברת נדרים פלוס, במידת הצורך ניתן לפנות לשירות הלקוחות ע"מ לבדוק פיתוח בחברות נוספות

בכדי להפעיל את האפשרות יש להגדיר

credit_card_create_token=yes

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

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

nedarim_plus_ApiValid=j%2biyEFN3bE

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

0548444444-nedarim_plus-7000000-3095=173333-1126-737-232323222

כאשר הערך הראשון במפתח מסמל את מספר הטלפון של בעל הכרטיס (מספר המתקשר בעת שמירת הכרטיס), הערך השני זה חברת הסליקה, הערך השלישי קוד המוסד או מספר חשבון שלכם אצל חברת הסליקה, הערך הרביעי 4 ספרות אחרונות של הכרטיס.
הערך הראשון בערך של המפתח הוא הטוקן, הערך השני התוקף של הכרטיס הערך השלישי זה 3 ספרות בגב הכרטיס (cvv), הערך הרביעי מספר הזהות.
לא כל הערכים בערך חייבים להיות, אבל ייתכן שמבלי חלק מהערכים הסליקה לא תעבור, זה תלוי בחברת האשראי.

ברירת מחדל מיקום הקובץ של הטוקנים היא באותה השלוחה, אם רוצים ניתן להגדיר שישמור וייקח את הנתונים משלוחה אחרת

credit_card_tokens_file_folder=/1/2

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

שליחת אישורים בדואר אלקטרוני

ברירת מחדל האישורים של הסליקות בהצלחה, וכן נסיונות הסליקה נמצאים בתיקיה שלכם גם הקובץ המקורי ymgr וגם הקובץ עם התצוגה היפה html

אם ברצונכם שבנוסף הקבצים יגיעו אליכם כל פעם למייל
על מנת שהקובץ של סליקות בהצלחה ישלח למייל בכל סליקה בהצלחה הגדירו:

credit_card_send_mail_ok=yes

אם ברצונכם שכל נסיון סליקה ישלח אליכם מייל עם כל הנסיונות הגדירו

credit_card_send_mail_log=yes

הדואר אלקטרוני לשליחת סטטוס סליקה (אישורים וכישלונות) הינו המוגדר במערכת, במידה ורוצים לשנות ניתן באמצעות ההגדרה הבאה:

email_address=aaa@ab.cd

ניתן להגדיר שישלח את המייל למייל נוסף

email_address2=mail@mail.com

ניתן לשנות את השם בדוא"ל באמצעות ההגדרה הבאה (במידה ולא משנים, השם נלקח משם הלקוח המוגדר במערכת)

email_name=avram

ביטול השמעת אישור

לאחר ביצוע עסקה בהצלחה מושמע מספר אישור. באם רוצים לבטל את שמיעת מספר האישור ולשמוע רק את הודעה M1430 'העיסקה התקבלה בהצלחה', יש להגדיר:

credit_card_skip_play_ok_number=yes

תפריט שמיעה נוספת של מספר האישור

ברירת מחדל נותן תפריט האם להשמיע שוב את מספר האישור
אם רוצים שלא ישמיע, אלא יתקדם מייד הלאה, ניתן להגדיר

credit_card_menu_another_confirmation_number_hearing=no

מעבר לשלוחה אחרת בסיום

לאחר מכן ברירת מחדל חוזרת שלב אחורה ניתן להגדיר ניתוב או ניתוק | ראה כאן את האפשרויות להגדרה.

ניתן להגדיר לעבור אם הסתיים התשלום בהצלחה - לשלוחה אחרת, לדוגמא

credit_card_end_goto=/8

כמו כן, ניתן להגדיר לעבור אם קיימת שגיאה - לשלוחה אחרת, לדוגמא

credit_card_error_goto=/8

הוראת_קבע

הוראת קבע

כרגע הוראת קבע פעיל רק דרך סליקה של חברת 'נדרים פלוס', וכן חברת פלאקארד, וחברת קשר קהילות.

[הערה חשובה: זה שלקוח מקבל אישור על הוראת קבע, זה רק אומר שחברת הסליקה (נדרים פלוס, פלאקארד, קהילות) בדקו כמה פרמטרים כלליים לגבי תקינות המספר, ומאשרים את קבלת הוראת הקבע. אין בדיקת התאמה אמיתית של חיוב הכרטיס מבחינת חסימה או שיוך לבעל הכרטיס, וכן כמובן אין אפילו הבטחה שהעיסקה תעבור בפועל בפעם הראשונה במועד החיוב הראשון. כמובן שאין הבטחה שהכרטיס לא יחסם בהמשך (בשונה מעסקת תשלומים שהאישור מגיע מחברת האשראי, כאן האישור מגיע מ'חברת הסליקה' על כך שהם קיבלו ושומרים את הפרטים, ותו לא).

ניתן להגדיר במקום חיוב חד פעמי, חיוב קבוע / חיוב על סכום מסוים כפול מספר חודשים. יש להגדיר:

credit_card_payment_type=keva

כמות חודשים לחיוב

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

credit_card_keva_min_tashloumim=5

בדוגמה, לא יהיה ניתן לבחור פחות מ 5 חודשים.

לחילופין, ניתן להגדיר:

credit_card_keva_tashloumim_amount=5
credit_card_keva_tashloumim_amount=none

בדוגמא הראשונה ההוראת קבע תהיה ל 5 פעמים
בדוגמא השניה יהיה ללא הגבלה, כלומר חיוב קבוע

מקסימום חודשים לחיוב/ תשלומים בהוראת קבע

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

credit_card_payment_type=tashloumim_keva

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

credit_card_payment_type=tashloumim_keva
billing_sum=1000
credit_card_min_tashloumim=5
credit_card_max_tashloumim=10

הסבר:
שורה ראשונה - התשלום ייגבה בתצורת הוראת קבע, אך ניתנת האפשרות ללקוח לבחור את כמות החודשים שהוא רוצה לפרוס את התשלום.
שורה שניה - הסכום הכולל לתשלום הינו 1000 שקלים.
שורה שלישית - מינימום 5 חודשים לבחירה.
שורה רביעית - מקסימום 10 חודשים שהלקוח יוכל לפרוס את התשלום.
אם הלקוח בחר לפרוס את התשלום ל-5 חודשים, הוא יחויב בכל חודש ב-200 שקלים.

יום חיוב בהוראת קבע

ברירת מחדל הלקוח יכול לבחור את יום החיוב
ניתן להגדיר

credit_card_payment_tashloumim_keva_day=15

ואז יום החיוב יהיה 15 לחודש בצורה קבועה
ניתן להגדיר כל יום שישנו בכלל החודשים (כלומר מ01 ועד 28)

הודעות מערכת הקשורות להוראת קבע

במקרה שהגדרתם את הערך של יום החיוב המערכת תודיע
M2557 יום החיוב החודשי הינו
M2558 לחודש

במקרה של תפריט יהיו הודעות
M2517 אנא הקישו את יום החיוב וסולמית לסיום
M2529 יום חיוב יכול להיות בין הראשון ועד ה28 לחודש בלבד

הודעות נוספות להוראת קבע
M2518 אנא הקישו את סכום החיוב בכל חודש וסולמית לסיום
M2519 בעיסקה זו תחוייבו בכל חודש בסך
M2520 כמות החודשים לחיוב היא
M2521 אנא הקש מספר חודשים לחיוב וסולמית, לחיוב קבוע אנא הקישו אפס וסולמית
M3967 מספר החודשים המינימלי לחיוב הינו..
M3968 חודשים
M2522 חיוב קבוע
M2523 תאריך החיוב הקרוב הוא

תפיסת_מסגרת

תפיסת מסגרת במקום חיוב מידי

כרגע פעיל רק דרך טרנזילה וקארדקום

credit_card_tranmode=grab_frame

במידה והגדרתם תפיסת מסגרת הודעות מערכת ישתנו ל
M2552 בעיסקה זו תיתפס מסגרת בסך
M2553 אנא הקישו את הסכום לתפיסת מסגרת וסולמית לסיום

יצירת טוקן בלבד - ללא תפיסת מסגרת או חיוב

כרגע פעיל רק בטרנזילה
ההגדרה היא

credit_card_payment_type=create_token_only

הודעות_ודוחות

הודעות מערכת

M1002 המקש שֶהוֹקַש שגוי

M1419 נא הקישו הסכום לחיוב

M1420 שקלים חדשים

M1034 לאישור הקישו 1, להקשה מחודשת 2.

M1421 הסכום חייב להיות גדול מ 0 שקלים, אנא נסו שנית

M1422 אנא הקישו את מספר כרטיס האשראי משמאל לימין ובסיום הקישו סולמית ליציאה הקישו כוכבית וסולמית

M1001 לא הוקשה בחירה

M1423 תוקף הכרטיס שגוי - יש להקיש תוקף ב4 ספרות חודש ב2 ספרות ושנה ב2 ספרות

M1424 נא הקישו את תוקף הכרטיס בארבע ספרות

M1425 קיימת שגיאת התחברות עם השרת, אנא נסו מחדש בעוד מספר דקות, תודה

M1428 נא הקישו את 3 הספרות בגב הכרטיס

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

M1599 עיסקה זו תחוייב בפריסה של

M1600 אנא הקש מספר תשלומים וסולמית לסיום

M1601 לא ניתן לבחור יותר מ36 תשלומים

M1602 בעיסקה זו ניתן עד

M1981 הסכום גבוה מידי

M1982 הסכום נמוך מידי

M3966 מספר התשלומים המינימלי לרכישה זו הינו..

M3967 מספר החודשים המינימלי לחיוב הינו..

M3968 חודשים

M1437 תשלומים

M1603 הסכום לכל תשלום לא יכול להיות קטן מעשרה שקלים

M1426 העיסקה נדחתה - סטטוס סירוב

M1427 אנא נסו שנית - עם כרטיס אחר

M1430 העיסקה התקבלה בהצלחה

M1533 העיסקה נקלטה בהצלחה

M1431 אישור מספר

M1432 לשמיעה חוזרת של מספר האישור הקישו 1 לסיום הרכישה והמשך הקישו 2

M1434 אין מספר מסוף

M1604 אין סוג סליקה

M1821 אין מספר חנות או פרויקט

M1822 לא הוגדר תוקן מסוף

M2577 "הטלפון שלך מזוהה במערכת כלקוח קשר קהילות,
להתחברות באמצעות הלקוח הקש את הסיסמה שלך בקשר קהילות וסולמית לסיום,
להמשך ללא התחברות הקישו כוכבית וסולמית."
M2578 שגיאה בטעינת הטוקן, הנכם מועברים להקשת כרטיס מלא

M4880 באפשרותכם לשמור את כרטיס האשראי לסליקות הבאות, פרטי הכרטיס יישמרו באופן מאובטח על ידי חברת האשראי, לשמירת פרטי הכרטיס הקישו 1 להמשך ללא שמירה הקישו 2
M4881 העיסקה עברה בהצלחה והכרטיס נשמר לפעמים הבאות
M4882 העיסקה עברה בהצלחה אך לא הצלחנו לשמור את הכרטיס לפעמים הבאות
M4883 לפי המעודכן יש לכם פרטי כרטיס אשראי שמור במערכת, הכרטיס מסתיים בספרות
M4884 לביצוע סליקה עם הכרטיס השמור הקישו 1 וסולמית לסליקה עם כרטיס אחר הקישו את מספר הכרטיס ולסיום סולמית, למחיקת הכרטיס השמור הקישו 0 וסולמית
M4885 לפי המעודכן יש לכם כרטיסי אשראי שמורים במערכת, לשמיעת וביצוע סליקה עם הכרטיסים השמורים הקישו 1 להמשך עם כרטיס אחר הקישו 2 למחיקת כרטיסים שמורים הקישו 3
M4886 לכרטיס המסתיים בספרות
M4887 הקישו
M4888 לאישור מחיקת כרטיס המסתיים בספרות
M4889 הקישו 1 לביטול הקישו 2 או המתינו
M4890 הכרטיס נמחק בהצלחה
M4891 מחיקת הכרטיס נכשלה
M4892 הסכום לתשלום בודד לפי מספר התשלומים שהקשתם אינו מגיע למינימום הנצרך, מינימום הסכום הנצרך לתשלום בודד הוא
M4893 הינכם מועברים להקשה מחדש של כמות התשלומים עד

דוחות סליקה

ישנם 2 סוגי דוחות. דו"ח אחד עבור כל הסליקות (גם סליקות שנכשלו). דו"ח שני עבור הסליקות שבוצעו בהצלחה בלבד.
הדוחות נשמרים בשלוחה שבה בוצעה הסליקה ובתיקיית Log שתחת השלוחה הראשית.

על מנת לערוך את תוכן הדוחות שמגיעים אליכם עליכם להכניס את הקבצים הבאים

שם הקובץ של דו"ח הסליקות הכללי
LogCreditCard.ymgr
הקובץ נשלח כ HTML בדוא"ל

שם הקובץ של דו"ח הסליקות שבוצעו בהצלחה
LogCreditCardOK.ymgr
הקובץ נשלח כ HTML בדוא"ל

הגדרות ברירת מחדל למילים

LogCreditCard.ini

וכן

LogCreditCardOK.ini

LogCreditCard=דו"ח סליקות כללי
Folder=שלוחה
DID=מערכת
IdType=סוג זיהוי
teudat_zehut=תעודת זהות
digits=הקשת ספרות
list=רשימה
phone=טלפון
enter_phone_list=רשימת טלפונים
EnterId=מספר זיהוי
ValName=שם
Phone=טלפון
Date=תאריך
Time=שעה
HebrewDate=תאריך עברי
CreditCardType= חברת סליקה
nedarim_plus=נדרים פלוס
kesherhk=קשר הוראות קבע
cardcom=קארדקום
tranzila=טרנזילה
pelecard=פלאקארד
TerminalNumber=מסוף
;UserName=שם משתמש
registerNumber=חנות
currency=מטבע (1-שקל,2-דולר אמריקאי,978-אירו)
BillingSum=סכום
CardNumberLatest=ספרות אחרונות
;id=תעודת זהות
Zeout=תעודת זהות
Tashloumim=תשלומים
Status=סטטוס
StatusNo=סטטוס מספר
DealSuccessfully=מספר אישור
Comments=הערות
CardDateMmyy=תוקף כרטיס
FAIL=נדחה
OK=מאושר
ERROR=שגיאה
000=מאושר
DealTxt=סטטוס במילים
Remarks=הערות
Day=יום חיוב
NextDate=תאריך חיוב הבא
Tashloumim=תשלומים
Invoice=חשבונית`code`