סייר
 
אפשריות
Rss קטגורייות

טבלת פרמטרים : קבלת פרטי עסקה מדף אישורית זהב

מספר מאמר: AA-00265 צפיות: 10372 נוצר: 24/05/2012 12:09 עדכון אחרון: 11/02/2021 13:05 0 דירוג/ מצביע

טבלת פרמטרים : קבלת פרטי עסקה מדף אישורית זהב לשרת צד ג'

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

על מנת להפעיל אפשרות זו יש לבצע הגדרה מתאימה בהגדרות->6. אישורית זהב -> 1. הגדרות לפי שפה.  למטה הגדרות למפתחים

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


מערכת הסליקה תבצע פנייה לדף לאחר סליקה שמבוצעת בפרוטוקול HTTP GET / POST  עם הפרמטרים הבאים (ראה דוגמה בסוף)

הערות:

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

שם לב ! יתכן ועם הזמן יתווספו פרמטרים נוספים לטבלה זו.

פרמטר תיאור ערכים אפשריים לדוגמה
responsecode קוד תשובה של ביצוע העסקה 0 - חיוב בהצלחה
אחרת חיוב נכשל
xparameter פרמטר מוחזר : ערך הפרמטר DealIdentityCode שנועבר לדף הסליקה.
ראה : טבלת פרמטרים : העברת פרמטרים לדף אישורית מספרים בלבד!
123
 terminalnumber  מספר מסוף מבצע העסקה 1000 
 ReturnData פרמטר מוחזר של הנתונים שהתקבלו ב טבלת פרמטרים : העברת פרמטרים לדף אישורית , מחרוזת 250 תווים  AFFI123
internaldealnumber מזהה ייחודי של העסקה במערכת אישורית זהב. רצוי לשמור פרמטר זה 12345
 suminfull  סכום עסקה בעשרוני 1.00 עבור שקל.
1 עבור עסקה של שקל.
(מקבלים סימן נקודה)
 suminagorot  סכום העסקה באגורות 100 עבור עסקה של שקל.
150 עבור עסקה של שקל וחצי.
(לא מקבלים סימן נקודה)

TotalCommition
 סה"כ עמלה שנגבתה 5
 cointype  מטבע חיוב 0  : מטבע ISO
1  : שקל
2 : דולר
4 : תשלומים דולר
8 : תשלומים שקל
ApprovelNumber
מספר אישור לעסקה מחברות האשראי
0012345
 responsdescription  תיאור התשובה בהתאם לקוד התשובה responsecode תקין 
 ProdName  שם המוצר  הנרכש    אופניים עם 4 גלגלים
 ProdGroupID מספר הקבוצה / הדף שאליה שייך המוצר. בהתאם מספר הקבוצה / הדף שמופיע במערכת הניהול  2
 GroupDescription  תיאור שם קבוצה קבוצה לדוגמה 
 ProdItemID  מספר הפריט . בהתאם למספר הפריט שמופיע במערכת הניהול 12 
 ProdQuantity  כמות המוצרים הנרכשים  1
CardOwnerName  שם בעל הכרטיס משה איבגי
CardOwnerPhone
טלפון בעל הכרטיס
050-8855444
CardOwnerID
תעודת זהות בעל הכרטיס
123456789
Lest4Numbers
4 ספרות של סיומת כרטיס
5874
MutagName
שם מותג הכרטיס  ראה:  קודי מותגויזה כאל
MutagId
קוד המותג   ראה:  קודי מותג
2
 UserEmail  כתובת דואר שהוקלד  MyEmail@Site.com
 UserIP  כתובת IP של המשתמש  UserIP
 ProductID  קוד פריט כפי שהמשתמש הגדיר על הפריט AVCD123 
 AffiliateID  קוד רשימת התפוצה שנבחרה 123 
 DelivarySum  סכום המשלוח שנבחר 100.12 
 DelivaryProductID קוד מוצר משלוח  ABC 
 NumberOfPaymentsToPrint מספר תשלומים כולל    6
 FirstPayment  בעסקת תשלומים מה סכום התשלום הראשון 13 
 ConstPayment בעסקת תשלומים מה הסכום שאר התשלומים 123  
IsTrumaDebite  האם מצב תרומה
true
 NumOfPaymentForTruma מספר תשלומים במצב תרומה 12
SuspendedDealId מספר העסקה המושהית ( במידה ויש עסקה מושהית )
55541
 RecurringCode  במידה ומוסיפים להוראת קבע בענן קוד התשובה של ההוספת 0 - הצלחה אחרת כישלון 
 RecurringIsNewAccount  הוראת קבע בענן : האם נוצר חשבון לקוח חדש true
 RecurringAccountID   הוראת קבע בענן : מספר חשבון לקוח החדש 123 
 RecurringOrderID  הוראת קבע בענן : מספר הוראה לחיוב  
CardYear תוקף הכרטיס YYYY
2019
CardMonthתוקף הכרטיס חודש M
12
Token
אסימון הכרטיס – רק למי שיש מודל הוראת קבע.
4cf8e168-XXXX-4613-XXXX-000332986b24

 פרטי חשבונית

 invNumber   מספר חשבונית 123 
 invType  סוג חשבונית 1 : חשבונית מס / קבלה
2 : קבלה  תרומה

 invResponseCode  קוד תשובה ליצירת חשבונית 0 : חשבונית נוצרה
אחר
קוד השגיאה של יצירת חשבונית 
 intTo  חשבונית לכבוד משה 
invCompanyID
תעודת זהות / ח.פ  לחשבונית
012345678
 intCity  חשבונית עיר אילת 
 InvAddress  חשבונית כתובת שורה אחת  
 InvAddress2  חשבונית כתובת שורה 2  
 InvPhone  טלפון חשבונית  
 InvMobile  טלפון נייד חשבונית  
 CouponNumber  מספר קופון שהוכנס במערכת  12GF11

שדות מותאמים אישית :

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

שדות מותאמים אישית מתחילים ב 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 תווים ואם נוסיף את השדות המותאמים יכול להיות מצב שהלקוח לא יגיע אל דף ההצלחה / כשלון.

 

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

 יש לפתוח את כל טווחי הכתובת הבאים בחומת האש של החברה (firewall) של החברה - גם ב cloudflare למי שיש 

- 82.80.227.17/255.255.255.248 (CIDR 29) >> מחשבון subnet

- 82.80.222.124/255.255.255.248 (CIDR 29) >> מחשבון subnet

 
ראו גם בכתבה נוספת באתר התמיכה ללקוחות >>>
 חיבור הסליקה לחנות וורדפרס - Wordpress Woocommerce Payment WOO


הערות
  • אין הערות למאמר זה.
תמיכה 03-9436100
כל הזכויות שמורות לחברת קארדקום בע"מ