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

 Featured
ממשק אחד שעושה הכול! חיוב , אסימון , חשבוניות ועוד... ( דף פרופיל נמוך, דף נחיתה, API 10 Redirect or IFRAME)

מספר מאמר: AA-00402 צפיות: 23424 נוצר: 25/12/2014 11:03 עדכון אחרון: 28/01/2019 11:01 87 דירוג/ 2 מצביע

ממשק אחד שעושה הכול! חיוב , אסימון , חשבוניות ועוד... ( דף פרופיל נמוך, דף נחיתה, API 10 Redirect or IFRAME)

 

מומלץ לפני פיתוח ממשקים לדבר עם התמיכה למפתחים לביצוע איפיון לפיתוח בטלפון :  03-9436100  -> 1. תמיכה ושירות -> 1. תמיכה אישורית זהב , או לפתוח קריאה באתר ונחזור אליכם.

2 סוגי התממשקויות פשוטות פופולריות:

1->סל קניות פשוט - מחזיק הכרטיס מוסיף פריטים לסל הקניות ומשלם חד פעמי בסוף ( +מודול חשבוניות אופציונאלי) - Operation =1

2->אתרי מנויים - לקוחות חוזרים או חיוב מחזורי של לקוחות כל חודש - Operation =2/3 בהתאם לאיפיון.

3->מעבר לזה מומלץ להתייעץ עם תמיכת ממשקים ולאפיין התממשקות


חובה לקרוא גם מאמרים נילווים למטה :

ממשק זה מתאים בעיקר:

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

ממשק זה מאפשר לבצע :

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

 שלבים לביצוע סליקה:

  1. יש לפנות לשרת אישורית זהב להעביר את הסכום שהמערכת שלכם רוצה לחייבם. ( מוסבר במאמר זה)
  2. להפנות את הרוכש אל דף הרכישה  ( מוסבר במאמר זה )
  3. לאחר סיום הרכישה של מחזיק הכרטיס במערכת קארדקום. קבלת פנייה ממערכת אישורית זהב אל דף במערכת שלכם עם תוצאות העסקה בהתאם לפרמטר IndicatorUrl  מאמר : פעולות : קבלה ומשיכה של תשובה משרת הסליקה אישורית זהב
  4. קבלת הלקוח לדף הצלחה / כישלון במערכת שלכם.

מצורף קודים לדוגמה בסוף המאמר.


ממשק Name to Value

כתובת Name to Value היא : https://secure.cardcom.solutions/Interface/LowProfile.aspx

הערות ל Name to Value:

  1. חובה לבצע פנייה רק ב POST.
  2. חובה לבצע urlencode לכל הערכים המועברים למערכת.
  3. יש להוסיף את הפרמטר codepage=65001  , פרמטר זה אומר את סוג הקידוד המועבר למערכת יוניקוד במקרה זה.
  4. התשובה המתקבלת היא במבנה : ResponseCode=4&Description=NoPemition&LowProfileCode=601

 

ממשק  API 10  Web Service

כתובת ה Web Service היא  : https://secure.cardcom.solutions/Interface/BillGoldService.asmx

יש להשתמש בפונקציה - CreateLowProfileDeal


הערות כלליות:

  1. את קוד התשובה של הבקשה ,פרמטר LowProfileCode,  המתקבל יש לשמור בצירוף להזמנה. קוד הפרופיל הנמוך הוא מסוג GUID באורך קבוע של 36.
  2. קוד תשובה שונה מ-0 אומר שגיאת מפתח תוכנה, יש לבצע התראה למנהל המערכת עם תיאור השגיאה.
  3. תוקף קוד פרופיל הנמוך הוא 15 דקות מעת יצירתו , ניתן לשנות את התוקף דרך הגדרות פרופיל נמוך.
  4. במידה ורוצים להפיק חשבונית מס / קבלה (מלכ"ר) לאחר החיוב יש להעביר גם פרמטרים לחשבונית  : טבלת פרמטרים : יצירת חשבונית מס / קבלה מלכ"ר.
  5. ניתן להעביר גם מידע נוסף שישמר במערכת אישורית זהב : טבלת פרמטרים : שדות בהתאמה אישית API 10

טבלת פרמטרים בפניה :

פרמטר תיאורערכים אפשריים לדוגמה
 Operation הפעולה שמערכת אישורית זהב צריכה לבצע.
שם לב  לפעולות יצירת אסימון ועסקה מושהית יש פרמטרים אופציונליים נוספים.		1. חיוב בלבד.
2. חיוב ויצירת אסימון.
3. יצירת אסימון בלבד.
4. עסקה מושהית.
TerminalNumber המסוף שמבצע את הפעולה1000
UserNameשם המשתמש לממשקים.MyTestUser 
SumToBillהסכום לחיוב 100.56
CoinIDמטבע לחיוב1 : שקל
2 : דולר
אחרת מטבע קוד מטבע ISO לפי מאמר:
רשימת קודי מטבעות לחיוב
Languageשפה להצגת דף הסליקהhe - עברית
en - אנגלית
ru - רוסית
ar - ערבית
שפות נוספות
ProductNameשם המוצר שיוצג למשתמש , אורך מקסימלי של 50. במידה ומיצרים חשבונית אין צורך להעביר , פרטי החשבונית יוצגו במקום שדה זההזמנה מספר C101G
 APILevel גרסה של API . גרסה אחרונה : 10 10
MaxNumOfPaymentsמספר התשלומים המקסימלי שהמשתמש יכול לבחור32
MinNumOfPaymentsמספר התשלומים המינימלי שהמשתמש יכול לבחור3
HideCreditCardUserIdהאם להסתיר את הקליטה של ת.ז. הלקוח - משתמש כאשר מחייבים לקוחות חו"לfalse
SuccessRedirectUrlהדף אילו יופנה מחזיק הכרטיס בסיום עסקה שהסתיימה בהצלחה. 
ניתן גם להגדיר באופן קבוע בהגדרות מערכת.
* במידה ויש שימוש ב IFRAME יש לדאוג שהקישור יהיה בקידומת https ולא http  *  (חובה כתובת חיצונית , לא localhost )
http://www.site.com/Success.html
ErrorRedirectUrlהדף אילו יופנה מחזיק הכרטיס בסיום עסקה שהסתיימה בכישלון.
ניתן גם להגדיר באופן קבוע בהגדרות מערכת.
* במידה ויש שימוש ב IFRAME יש לדאוג שהקישור יהיה בקידומת https ולא http  *  (חובה כתובת חיצונית , לא localhost )		http://www.site.com/Error.html
IndicatorUrlדף ניסתר(דף דיווח קבלת פרטי עסקה ) לקבלת פרטי העסקה. המערכת קורא לדף זה לפני שהלקוח מועבר לדף הצלחה / כישלון.
לאחר קבלת פרטי העסקה יש לפנות את שרת אישורית זהב לבדיקת הנתונים , ראה מאמר : טבלת פרמטרים : קבלת תשובה משרת הסליקה אישורית זהב  .
1.כתובת לדיווח משרת לשרת על העסקה שבוצעה.
2.חובה לשימוש!(חובה כתובת חיצונית , לא localhost ).

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

4. מומלץ להעביר מספר הזמנה ולקבל אותו חזרה בפרמטר ReturnValue

5.אם שרת בית העסק לא מחזיר תשובת HTTP-200 השרת של קארדקום יפנה שוב ושוב לדיווח העסקה 7 פעמים:
[הטווח בדקות לדיווח שני והלאה: 1 דקה , 2 , 2 , 16 , 60  דק, 12 שעות , 12 שעות]. 
ראה מדריך : דוח פעילות פרופיל נמוך		http://www.stie.com/hide.aspx
CancelUrlבמידה ומוצג לחצן "חזור" לאין יחזור הלקוח.
* במידה ויש שימוש ב IFRAME יש לדאוג שהקישור יהיה בקידומת https ולא http  *		http://www.site.com/Cart.aspx
CancelTypeסוג פעולה של לחצן חזור 0 - לא להציג לחצן חזור
1 - מדמה לחצן חזור בדפדפן
2 - חוזר אל דף חזור שהועבר  
SumInStarsסכום לחיוב כרטיס בכוכבים0
HideCVVהאם להסתיר את שדה CVV , משתמש למסופים הוראת קבע שבהם אין חובה של CVV.false
CreditTypeשם לב!

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

במידה ולא מעברים את הפרמטר אז מבוצע חיוב רגיל או תשלומים רגילים.
ReturnValue
(מומלץ לשימוש)
ערך להעביר למערכת הסליקה אשר יוחזר בדף הצלחה / INDICATOR.
עד 250 תווים. ( נהוג להעביר מספר הזמנה ממערכת הזמנות באתר )
AA-1234
DefaultNumOfPayments  מספר התשלומים שיהיה בחורים מראש ללקוח. לדוגמה: 
אם ניתן לשלם ב 12 תשלומים ניתן להעביר את הערך 10 ואז מספר התשלומים שיהיו בחור הוא 10.
מספרים בלבד. 1-32		 10
CardOwnerName שם בעל הכרטיס
אלי כהן
HideCardOwnerNameהאם לא להציג את השדה שם בעל הכרטיס.
מחרוזת 		 מחרוזת:  true  להסתיר 
אחרת מציג.
 SapakMutavמספר לקוח בעבודה ברב מוטב 1234
 RefundDealהאם לבצע זיכוי לפרטי האשראי - פעיל בחיוב בלבד. true 
 ShowCardOwnerPhoneהאם להציג שדה טלפון בעל הכרטיס בפרטי האשראי true 
CardOwnerPhone טלפון בעל הכרטיס
050-55445841
ReqCardOwnerPhone האם שדה טלפון בעל הכרטיס חובה false 
CardOwnerEmail אימייל הלקוח (נכנס לפרטי עסקה , לא ניכנס לחשבונית ! )
eli1980@gmail.com
ShowCardOwnerEmail האם להציג EMAIL בעל הכרטיס true 


ReqCardOwnerEmail האם Email בעל הכרטיס שדה חובה true 
ShowInvoiceHead האם להציג ולאפשר ערכיה של פרטי החשבונית ללקוח. פעיל במידה ומפיקים חשבונית. פרטים להזנה לחשבונית .
 true
AutoRedirect במידה ומבצעים פנייה בFORM POST יש להעביר פרמטר זה true .
המערכת תבצע הפנייה של הלקוח לדף הסליקה באופן אוטומטי.		true 
 InvoiceHeadOperationאפשריות נוספות במידה ומעבירים פרטי חשבונית.
0 - לא ליצור חשבוניות ולא להציג.
1 - צור חשבונית לפי פרטי החשבונית שהועברו. - ברירת מחדל אם מעבירים פרטי חשבונית.
2 - הצג פרטי חשבונית אבל לא לבצע יצירה של חשבונית!
במידה ולא רוצים ליצור חשבונית אלה רק להציג את פרטי הרכישה יש העביר את הפרמטר הזה עם ערך 2.

שדה מחרוזת.
 IsVirtualTerminalModeהאם זה סליקה של בית העסקת ?
המערכת תתנהג כמו מסוף ווירטואלי לבית העסק ותציג שדות נוספים.
הדף יציג שדה נוסף של הזנת מספר אישור שבית העסק צריך להעביר.
"true" 
IsOpenSum עובד רק במצב של IsVirtualTerminalMode=true הפרמטר יאפשר לסוחר לעדכן את הסכום בעת החיוב
"true"
 ChargeOnSwipe  כאשר מעבירים פס מגנטי ( ערוץ 2 ) יבוצע ישר החיוב TRUE = בפס מגנטי יבוצע ישר חיוב
DocTypeToCreate לא חובה , ממולץ לא להעביר המערכת יודעת לבד איזה מסמך להפיק לפי ההגדרות שמוגדרות ברמת המסוף.
במידה והמתכנת רוצה לדרוס את הסוג מסמך ניתן לפי פרמטר זה .
1- חשבונית מס קבלה
3 - קבלה מלכ"ר
101 - אישור הזמנה מאתר
400 - קבלה רגילה (לחשבונית) 
CSSUrl 
כתובת URL של קוד CSS שהמערכת תוסף לדף התשלום.

מומלץ שהכתובת תתחיל ב HTTPS. 

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

 https://www.site.co.il/mycss.css

פרמטרים נוספים אופציונליים לפעולות של 2 - "חיוב ויצירת אסימון"    3 -"יצירת אסימון בלבד"

פרמטרתיאורערכים אפשריים לדוגמה
 CreateTokenDeleteDateעד מתי לשמור את האסימון.
על פי תקן PCI DSS אין כרטיס אשראי יותר ממה שצריך.
במידה ולא מעבירים האסימון נשמר עד תוקף הכרטיס.		01/01/2025
 CreateTokenJValidateType סוג הבדיקה שתבוצע על הכרטיס בעת יצירת אסימון בלבד
J2- בדיקה רק של סיפרת ביקורת של הכרטיס. - לא ניתן לחייב כרטיס במידה והמסוף חייב ב CVV !
J5- בדיקה ושריון של הסכום המועבר בחברות האשראי בין שלושה ימים לשבוע וקבלת 
קוד אישור חד פעמי. את קוד האישור יש להעביר בעת חיוב האסימון. שימוש בJ5 מותנה באישור חברות האשראי.
פרמטר האישור המתקבל בחזרה משרת החיוב הוא: TokenApprovalNumber

לקוחות שסולקים עם UPAY אין להעביר פרמטר בחיוב זה. במידה ומועבר הכסף יתקבל ב 15 לחודש הבא.
2 - בדיקה J2
5 - בדיקה J5

פרמטרים נוספים אופציונליים לפעולה 4 - "עסקה מושהית".

פרמטרתיאורערכים אפשריים לדוגמה
 SuspendedDealJValidateTypeסוג הבדיקה שתבוצע על הכרטיס 
J2- בדיקה רק של סיפרת ביקורת של הכרטיס.
J5- בדיקה ושריון של הסכום המועבר בחברות האשראי וקבלת קוד אישור
שימוש בJ5 מותנה באישור חברות האשראי.
2 - בדיקה J2
5 - בדיקה J5
 SuspendedDealGroup קוד קבוצה  - משמש להצגת הלקוחות בדוח לפי חתכים בדוחות במערכת אישורית זהב. 
0

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

טבלת פרמטרים התשובה המתקבלת :

פרמטר תיאורערכים אפשריים לדוגמה
ResponseCodeקוד תשובה המקבל לבקשה של המפתח.0 - תקין ,אחרת שגוי - שגיאת פיתוח.
 Descriptionתיאור התשובה , במידה ומתקבל שונה מ-0 יש לבצע רישום והתראה למנהל המערכתתקין 
 LowProfileCodeקוד פרופיל נמוך - קוד המזהה הייחודי של העסקה  יש לשמור קוד זה על ההזמנה בבסיס הנתונים
 url כתובת ב URL של הדף שנוצר שיש להעביר את מחזיק הכרטיס לביצוע סליקה.https://secure.cardcom.solutions/SomePage.aspx 
 PayPalUrlכתובת URL להעברת הלקוח ישירות ל PAYPAL - מתאים להוספת לחצן באתר "רכישה PAYPAL" ישירות מבלי לעבור דרך דף הסליקה של קארדקום - שם לב יש לבצע הגדרות של PAYPAL במסוף. 
מתאים בעיקר לעבודה עם IFRAME		 

 

* ניתן להיכנס למסוף ולבדוק : דוחות 7 דוח פעילות פרופיל נמוך ממשק אתרים - ולראות מידע למפתח

 תרשים תהליך העבודה :




קבצים מצורפים
Uni_Interface_Iframe_And_Invoice.php.txt 4.1 Kb הורדת קובץ
UniInterfaceDemoSiteCodeC_charp.zip 20.1 Mb הורדת קובץ
מאמר קָשׁוּר
  1. פעולות : קבלה (או משיכה) של תשובה משרת הסליקה אישורית זהב
  2. טבלת פרמטרים : יצירת מסמך (חשבונית / קבלה וכו)
  3. פעולות : חיוב / זיכוי אסימון
  4. טיפים לעבודה ב IFRAME .
  5. קוד לדוגמה : IFrame / Redirect עבודה ב Form Method Post. API 10
הערות
  • אין הערות למאמר זה.
תמיכה 03-9436100
כל הזכויות שמורות לחברת קארדקום בע"מ
Knowledge Base by: KnowledgeBase Manager Pro v6.2.2 (Built with: JS.GUI - AJAX Framework)