ניתן לקבל את פרטי העסקה שבוצע בדף אישורית זהב בדחיפה לאתר שלך או לאתרים צד ג' .
לדוגמא חיבור למערכות crm , zapier , וכו .
על מנת להפעיל אפשרות זו יש לבצע הגדרה מתאימה בהגדרות >5. אישורית זהב > 1. הגדרות לפי שפה. למטה הגדרות למפתחים
בשדה "האם לבצע וידוא עסקה" יש לבחור "כן" ולהוסיף את "כתובת קבלת פרטי עסקה" המתאימה.
מערכת הסליקה תבצע פנייה לדף לאחר סליקה שמבוצעת בפרוטוקול HTTP GET / POST עם הפרמטרים הבאים ( ראה דוגמה בסוף )
הערות:
- פרמטרים באדום תמיד מועברים , שאר הפרמטרים מועברים רק אם קיימים במערכת.
- הדיווח הוא על סליקה שבוצע בהצלחה וכישלון . יש לבדוק הפרמטר responsecode לראות אם העסקה בוצעה בהצלחה.
- לא לשכוח להפעיל את הפנייה בהגדרות אישורית זהב.
- ניתן לשנות את שמות הפרמטרים על מנת להתאים אותם למערכות שונות דרך : הגדרות -> דף אישורית זהב -> שינוי שמות לממשק.
- ניתן להגדיר דיווחים גם ב רמת דף אישורית בודד ( בעריכת דף - לשונית מתקדם - האם לבצע דיווח עסקה נוסף )
שים לב ! יתכן ועם הזמן יתווספו פרמטרים נוספים לטבלה זו.
| מספר | פרמטר | ערכים אפשריים לדוגמה | תיאור |
| 1 | responsecode | 0 - חיוב בהצלחה אחרת חיוב נכשל |
קוד תשובה של ביצוע העסקה |
| 2 | xparameter | 123 | פרמטר מוחזר : ערך הפרמטר DealIdentityCode שנועבר לדף הסליקה. ראה : טבלת פרמטרים : העברת פרמטרים לדף אישורית מספרים בלבד! |
| 3 | terminalnumber | 1000 | מספר מסוף מבצע העסקה |
| 4 | ReturnData | AFFI123 | פרמטר מוחזר של הנתונים שהתקבלו ב , מחרוזת 25 תווים |
| 5 | internaldealnumber | 12345 | מזהה ייחודי של העסקה במערכת אישורית זהב. רצוי לשמור פרמטר זה |
| 6 | suminfull | 1.00 עבור שקל. 1 עבור עסקה של שקל. (מקבלים סימן נקודה) |
סכום עסקה בעשרוני |
| 7 | suminagorot | 100 עבור עסקה של שקל. 150 עבור עסקה של שקל וחצי. (לא מקבלים סימן נקודה) |
סכום העסקה באגורות |
| 8 | cointype | 0 : מטבע ISO 1 : שקל 2 : דולר 4 : תשלומים דולר 8 : תשלומים שקל |
מטבע חיוב |
| 9 | ApprovelNumber | 0012345 | מספר אישור לעסקה מחברות האשראי |
| 10 | responsdescription | תקין | תיאור התשובה בהתאם לקוד התשובה responsecode |
| 11 | ProdName | אופניים עם 4 גלגלים |
שם/תיאור המוצר הנרכש בריבוי פריטים שנרכשו ("בחירה מרובה"), פריט ראשון יופיע ProdName, שני ואילך ממוספרים. (ProdName, ProdName1, ProdName2...) |
| 12 | ProdGroupID | 2 | מספר הקבוצה / הדף שאליה שייך המוצר. בהתאם מספר הקבוצה / הדף שמופיע במערכת הניהול |
| 13 | GroupDescription | קורסים | תיאור שם קבוצה/דף |
| 14 | ProdItemID | 2 | מספר הפריט . בהתאם למספר הפריט שמופיע במערכת הניהול של קארדקום. |
| 15 | ProdQuantity | 1 |
כמות שנרכשה עבור פריט (ProdQuantity, ProdQuantity1, ProdQuantity2...) |
| ProdPrice | 50 |
מחיר הפריט הנרכש |
|
| 16 | CardOwnerName | אלי כהן | שם בעל הכרטיס |
| 17 | CardOwnerPhone | 050-8855444 | טלפון בעל הכרטיס |
| 18 | CardOwnerID | 123456789 | תעודת זהות בעל הכרטיס |
| 19 | Lest4Numbers | 5874 | 4 ספרות של סיומת כרטיס |
| 20 | MutagName | ויזה כאל | שם מותג הכרטיס ראה: קודי מותג |
| 21 | MutagId | 2 | קוד המותג ראה: קודי מותג |
| 22 | UserEmail | MyEmail@Site.com | כתובת דואר שהוקלד |
| 23 | UserIP | UserIP | כתובת IP של המשתמש |
| 24 | ProductID | AVCD123 | קוד פריט / מק"ט כפי שהמשתמש הגדיר על הפריט. בריבוי פריטים שנרכשו ("בחירה מרובה"), פריט ראשון יופיע ProductID, שני ואילך ממוספרים. (ProductID, ProductID1, ProductID...) |
| 25 | AffiliateID | 123 | קוד רשימת התפוצה שנבחרה |
| 26 | DelivarySum | 100.12 | סכום המשלוח שנבחר |
| 27 | DelivaryProductID | ABC | קוד מוצר משלוח |
| 28 | NumberOfPaymentsToPrint | 6 | מספר תשלומים כולל |
| 29 | FirstPayment | 13 | בעסקת תשלומים מה סכום התשלום הראשון יש לחלק חלקי 100 , הסכום מופיע באגורות |
| 30 | ConstPayment | 123 | בעסקת תשלומים מה הסכום שאר התשלומים יש לחלק חלקי 100 , הסכום מופיע באגורות |
| NumberOfPaymentsToPrint | 3 | מספר תשלומים כולל שמודפס על החשבונית | |
| 31 | IsTrumaDebite | true | האם מצב תרומה |
| 32 | NumOfPaymentForTruma | 12 | מספר תשלומים במצב תרומה |
| AffiliateID | 12 | מספר אפליאט אי די / מספר הדף | |
| 33 | RecurringCode | 0 - הצלחה אחרת כישלון | במידה ומוסיפים להוראת קבע בענן קוד התשובה של ההוספת |
| 34 | RecurringIsNewAccount | true | הוראת קבע בענן : האם נוצר חשבון לקוח חדש |
| 35 | RecurringAccountID | 123 | הוראת קבע בענן : מספר חשבון לקוח החדש |
| 36 | RecurringOrderID | 3 | הוראת קבע בענן : מספר הוראה לחיוב |
| 37 | CardYear | 2019 | תוקף הכרטיס YYYY |
| 38 | CardMonth | 12 | תוקף הכרטיס חודש M |
| 39 | Token | 4cf8e168-XXXX-4613-XXXX-000332986b24 | אסימון הכרטיס – רק למי שיש מודל הוראת קבע. |
| 40 |
SuspendedDealId |
1451512 | מספר עסקה מושהית שנוצרה |
| 41 |
screamid |
1055 | מספר scream למי שעובד עם ממשק זה |
| 42 |
TotalCommition |
2.5 | עמלה שחברת UPAY גבתה במקרה של תשלומים בקרדיט במסופי UPAY |
פרטי חשבונית
| מספר | פרמטר | ערכים אפשריים לדוגמה | תיאור |
| 1 | invNumber | 123 | מספר חשבונית |
| 2 | invType | 1 : חשבונית מס / קבלה 2 : קבלה תרומה |
סוג חשבונית |
| 3 | invResponseCode | 0 : חשבונית נוצרה אחר קוד השגיאה של יצירת חשבונית |
קוד תשובה ליצירת חשבונית |
| 4 | intTo | משה | חשבונית לכבוד |
| 5 | invCompanyID | 012345678 | תעודת זהות / ח.פ לחשבונית |
| 6 | intCity | אילת | חשבונית עיר |
| 7 | InvAddress | חשבונית כתובת שורה אחת | |
| 8 | InvAddress2 | חשבונית כתובת שורה 2 | |
| 9 | InvPhone | טלפון חשבונית | |
| 10 | InvMobile | טלפון נייד חשבונית | |
| 11 | CouponNumber | 12GF11 |
מספר קופון שהוכנס במערכת |
| ProdPrice | 50 |
מחיר פריט |
|
| 12 | ProdTotalLines | 2 |
מספר כולל של שורות מסמך |
שדות מותאמים אישית:
בנוסף לפרמטרים הקבועים ישנם שדות מותאמים אישית המועברים גם הם.
שדות מותאמים אישית מתחילים ב Custom ולאחר מיכן שתי ספרות של מספר השדה כפי שמופיע במערכת הניהול. רק שדות עם ערך מועברים בממשק .
לדוגמה אם הלקוח הקליד ערך בשדות מספר 4 ו8 מה שיעבור הוא :
Custom04=Today&Custom08=Male
דוגמה לפנייה:
http://www.yoursite.co.il/yourpage.aspx?responsecode=0&UserEmail=yaniv@smsendsr.co.il&suminfull=120.50 .....
שם לב!
שדות מותאמים אישית מועברים אך ורק לדף "וידוא עסקה" ולא מועברים לדף הצלחה וכישלון. הסיבה היא שישנם עדין דפדפנים שמגבילים את אורך ההפניה ל2048 תווים ואם נוסיף את השדות המותאמים יכול להיות מצב שהלקוח לא יגיע אל דף ההצלחה / כישלון.
ניתן לראות LOG של הדיווח על העסקה עצמה בדוחות סליקה יש ללחוץ על העסקה עצמה .
ולאחר מכן יש ללחוץ על לשונית ממשקים .
ניתן לבדוק את הדיווחים כאן.
הטיים אווט של הדיווחים הם 10 שניות בדיווח הראשון .
אם לא מצליח שולח שוב ושוב 7 ניסינות
ניתן להיעזר באתר זה :
https://meyerweb.com/eric/tools/dencoder/
במקרה שהמערכת לא תצליח לדווח למתכנת גם , בעל העסק יקבל התראה על כך - מצב תמונה.
* במקרה של תקלה בדיווח עסקה מהשרת של קארדקום לשרת של הלקוח *
נדרש לפתוח את כל טווחי הכתובת הבאים בחומת האש של החברה (גם ב cloudflare למי שיש)
- 82.80.227.17/255.255.255.248 (CIDR 29) >> מחשבון subnet
- 82.80.222.124/255.255.255.248 (CIDR 29) >> מחשבון subnet
הערות
0 הערות
היכנס למערכת כדי להגיב.