שלב 3 - חיוב של אסימון \ תפיסת מסגרת \ חיוב פרטי אשראי בממשק ישיר. (Do Transaction)

מתי להשתמש בפונקציה זו?

פונקציה זאת בדרך כלל תהיה בשימוש לאחר שלב 1 + 2,

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

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

מה זה "ממשק ישיר"?

ממשק ישיר מיועד למערכות סגורות ומאובטחות או לאפליקציות נייטיב (iOS / Android) סגורות. חיוב באמצעות ממשק ישיר מתבצע ללא הפניה לדף סליקה של קארדקום בתקן PCI.

חשוב לציין: מודל ממשק ישיר לא מיועד לאתרים באינטרנט (WEB). למערכות כאלה יש להשתמש במודול "פרופיל נמוך".

בממשק ישר, בWEB חייב תקן PCI, בלי זה העסק חשוף לפריצות ולהונאות.

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

תהליך החיוב בממשק ישיר.

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

פעולות נפוצות בפונקציה "Do Transaction".

בפונקציה "Do Transaction" ניתן לבצע את הפעולות הבאות:

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

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

דרישות & מודלים נחוצים.

מסוף ללא דרישה לCVV - בשביל מודל אסימונים.

מודל אסימונים - בשביל חיוב וזיכוי אסימון.

מודל ממשק ישיר - בשביל ביצוע עסקאות במערת סגורה IOS.

שלב שלוש - חיוב אסימון & חיוב פרטי אשראי - Do Transaction.

להלן קישור לפונקציה בJSON.

שיטת בקשה POST.

Do Transaction

https://secure.cardcom.solutions/api/v11/Transactions/Transaction

להלן הפרמטרים שצרים להעביר בפונקציה Do Transaction.

מקרא:

פרמטר אדום - חובה

פרמטר מודגש - מומלץ

פרמטר לא אדום ולא מודגש - אופציונלי

מספר	שם פרמטר	ערכים אפשריים לדוגמא	תיאור
1	TerminalNumber	1000	המסוף שמבצע את הפעולה. יש לקבל פרמטר זה מבית העסק. - מספר מסוף פנימי לא שבא.
2	ApiName	Cardcomtest26	שם משתמש ממשקים. יש לקבל פרמטר זה מבית העסק.
3	Amount	100	הסכום לחיוב.
4	CardNumber	"4580280000000008"	מספר כרטיס אשראי לחיוב- נועד למודול ממשק ישיר (ללא תקן PCI)
5	Token	"4cf8e168-261e-4613-8d20-000332986b24"	האסימון לחיוב
6	CardExpirationMMYY	"1226"	תאריך תוקף של האסימון - חיוני
7	CVV2	"078"	שלוש ספרות אבטחה של הכרטיס אשראי- עובד רק עם מספר אשראי (לא טוקן)
8	ExternalUniqTranId	"h9rZs#4VxTp!7kLb0wUeG3zC"	מזהה עסקה ייחודי חיצוני, חיוני לשלוח את המזהה העסקה הייחודי שלך כדי למנוע עסקה כפולה. אם אותו מזהה עסקה ייחודי חיצוני יישלח שוב, תקבל קוד שגיאה 608. ראה 'ExternalUniqTranIdResponse'.
9	ExternalUniqUniqTranIdResponse	boolean - true \ false	false - יחזיר קוד שגיאה 608 אם אותו 'ExternalUniqTranId' ישתמש שוב, true - לא יחייב את הכרטיס, אבל יחזיר את התגובה המקורית של העסקה.
10	NumOfPayments	12	מספר תשלומים לעסקה.
11	CardOwnerInformation אובייקט עם פרמטרים.	Phone "0522222222" --------------------------------- FullName "דניאל טסט" --------------------------------- IdentityNumber "321654987" --------------------------------- CardOwnerEmail "test@gmail.com" --------------------------------- AvsZip "string" --------------------------------- AvsAddress "string" --------------------------------- AvsCity "string"	Phone מספר טלפון של הלקוח. --------------------------------- FullName שם הלקוח. --------------------------------- IdentityNumber מספר תעודת זהות של הלקוח. --------------------------------- CardOwnerEmail האימייל של הלקוח. --------------------------------- AvsZip AVS פעיל רק ק מסופי EMV .( מסוף EMV – כול המסופים שנפתחו משנת 9.2017 והלאה, אחרת יש לבדוק מול התמיכה של קארדקום לביצוע הסבה.) מיקוד הלקוח. --------------------------------- AvsAddress AVS פעיל רק ק מסופי EMV .( מסוף EMV – כול המסופים שנפתחו משנת 9.2017 והלאה, אחרת יש לבדוק מול התמיכה של קארדקום לביצוע הסבה.) כתובת הלקוח. --------------------------------- AvsCity AVS פעיל רק ק מסופי EMV .( מסוף EMV – כול המסופים שנפתחו משנת 9.2017 והלאה, אחרת יש לבדוק מול התמיכה של קארדקום לביצוע הסבה.) עיר הלקוח.
12	ISOCoinId	1 - שקל 2 - דולר לקודי מטבע נוספים - רשימת קודי מטבעות	מטבע לחיוב העסקה.
13	CustomFields מערך עם אובייקטים בתוכו.	Id (integer) - 1 Value (string) - "ערך לדוגמא"	שדות מותאמות אישית. מצוין אם רוצים להעביר מידע נוסף של עסקה הלאה לצורך דיווחים ולצורך איסוף מידע. Id - המספר המזהה של השדה מותאם אישית Value - הערך של השדה המותאם אישית זה מערך שבתוכו יש אובייקטים.

ערכים של אובייקט Advanced (14).

פרמטר אדום - חובה

פרמטר מודגש - מומלץ

פרמטר לא אדום ולא מודגש - אופציונלי

מספר	שם פרמטר	ערכים אפשריים לדוגמא	תיאור
1	ApiPassword	"kzFKfohEvL6AOF8aMEJz"	סיסמת API, מיועד לזיכוי וביטול עסקאות.
2	IsRefund	boolean - true \ false	האם זו הייתה עסקה זיכוי
3	ISOCoinName	ILS \ USD \ EUR	המקביל לפרמטר ISOCoinId, בפרמטר הזה מקבלים את השם מטבע ולא את המספר מטבע.
4	JValidateType	(integer) - 2 \ 5	איזו סוג פעולה לעשות על הפרטי אשראי \ אסימון. 2 - J2 האם לעשות בדיקת כרטיס בלבד. 5 - J5 האם לעשות תפיסת מסגרת ובדיקת אשראי.
5	SapakMutav	(string) \ 1234	מספר לקוח בעבודה ברב מוטב
6	CreditType	1 - חיוב רגיל 6 - קרדיט בתשלומים במידה ולא מעבירים את הפרמטר אז מבוצע חיוב רגיל או תשלומים רגילים	שים לב! 1. חברות האשראי מגבילות את מספר התשלומים למינימום 3. במקרה זה אנו מסדרים את מספר התשלומים למינימום 3 באופן אוטומטי. 2. חברות האשראי מגבילות את הסכום המינימלי לחיוב עסקאות קרדיט. יש לדאוג להעביר סכום מתאים. במקרה זה הלקוח יועבר לדף כישלון.
7	MTI	420 (ערך קבוע)	פרמטר לשחרור מסגרת אשראי. דרוש להעביר אתו את המספר אישור, שזה מספר העסקה בקארדקום של התפיסת מסגרת בפועל. (ApprovalNumber)
8	AccountIdToGetCardNumber	123	לשים בערך של הפרמטר את הערך של AccountID (מזהה כרטיס לקוח) ייתן את מספר הכרטיס ותאריך התפוגה מהחשבון, אם אתה צריך את המידע על החשבון עבור החשבונית, עליך לשלוח את מזהה החשבון באובייקט המסמך: Document.AdvancedDefinition.AccountID ו-Document.AdvancedDefinition.IsLoadInfoFromAccountID=true.
9	ApprovalNumber	12345	מספר אישור חד פעמי שמתקבל בעת יצירת אסימון עם בדיקה מסוג J5 בשלב 1. במקרה ורוצים לחייב תפיסת מסגרת שנעשתה בשלב, צריך להעביר את מספר אישור זה, ביחד עם הטוקן והסכום לחיוב.
10	FirstPayment	50	אופציונאלי - סכום תשלום ראשון בתשלומים לב! הסכומים הם באגורות - ראה הערה בסוף הטבלה
11	ConstPayment	20	אופציונאלי - סכום שאר התשלומים לב! הסכומים הם באגורות - ראה הערה בסוף הטבלה
12	IsAutoRecurringPayment	boolean - true \ false	כאשר TRUE, הסוג חיוב בממשק יהפוך להיות סוג חיוב הוראת קבע במקום פרופיל נמוך - אך זה לא יקים הוראת קבע. נועד בעיקר למוחלפים, בשביל שיהיה עליו סוג חיוב הוראת קבע, והכרטיס יכנס לשירות מוחלפים. יש להעביר פרמטר זה כ true רק כאשר המסוף מוגדר מסוף הוראת קבע בחברת האשראי ו ש.ב.א. ראו סוגים :סוגי מסופים מול חברות האשראי אם המסוף מוגדר טלפוני/ רגיל ללא CVV אין להעביר פרמטר זה. מסוף הו"ק נועד אם רוצים לקבל קובץ מוחלפים מחברות האשראי .והעסקאות יוצגו למחזיק הכרטיס כ עסקת הוראת קבע . עדכון קובץ מוחלפים מחברת האשראי אין הגבלה בסוג הכרטיס בשימוש בהוראת קבע , המערכת מזהה את סוג הכרטיס ופועלת בהתאם.( כרטיס דואר , חיוב מיידי וכו)
13	IsCreateToken	boolean - true \ false	האם ליצור אסימון מפרטי האשראי?
14	SendNote	boolean - true \ false	האם לשלוח פתקית של העסקה שבוצעה.

ערכים של אובייקט Document (15).

**דגש חשוב! אמנם מערך של products הוא לא חובה אך בלעדיו לא יופק המסמך ולכן מסומן כמומלץ

פרמטר אדום - חובה

פרמטר מודגש - מומלץ

פרמטר לא אדום ולא מודגש - אופציונלי

מספר	שם פרמטר	ערכים אפשריים לדוגמא	תיאור
1	DocumentTypeToCreate	"Auto" - אוטומטי, לפי מה שיש בהגדרות 3->4. "TaxInvoiceAndReceipt" – חשבונית מס וקבלה "TaxInvoiceAndReceiptRefund" – חשבונית זיכוי והחזר כספים "Receipt" – קבלה מלכ''ר "ReceiptRefund" – קבלה מלכ"ר זיכוי ( החזר כספים) "Quote" – הצעת מחיר "Order" – הזמנה "OrderConfirmation" – אישור הזמנה - מאתר "OrderConfirmationRefund" – זיכוי אישור הזמנה - מאתר "DeliveryNote" – תעודת משלוח "DeliveryNoteRefund" – תעודת החזרה "ProformaInvoice" – חשבון עסקה "DemandForPayment" – דרישה לתשלום "DemandForPaymentRefund" – ביטול דרישה לתשלום "ProformaDealInvoice" – חשבון קבלה פרופורמה "ProformaDealInvoiceRefund" –חשבון קבלה זיכוי "TaxInvoice" – חשבונית מס "ProformaInvoiceRefund" – זיכוי חשבון עסקה "TaxInvoiceRefund" – חשבונית מס זיכוי "ReceiptForTaxInvoice" – קבלה (לחשבונית) "DonationReceipt" – קבלה על תרומה "DonationReceiptRefund" – זיכוי קבלה תרומה (החזר כספים) "ReceiptForTaxInvoiceRefund" – החזר כספים לקוחות (קבלה זיכוי)	סוג המסמך להפקה.
2	Name	"מר טסט"	שם הלקוח.
3	TaxId	040617640	מספר ת.ז. או ח.פ חברה
4	Email	israel@gmail.com	כתובת דואר הלקוח , שלשם ישלח המסמך. (ניתן לשרשר כמה מיילים באמצעות נקודה פסיק ; )
5	IsSendByEmail	true \ false	האם לשלוח מסמך בדואר אלקטרוני.
6	AddressLine1	"Saharov 22"	כתובת לקוח , שורה ראשונה.
7	AddressLine2	"P.O. 1234"	כתובת לקוח, שורה שנייה.
8	City	Reshin-Le-Zion	עיר
9	Mobile	03-9619611	טלפון קווי
10	Phone	0549876543	טלפון נייד (במודול SMS ישלח SMS לנייד זה)
11	Comments	דוגמא: אחריות של שנה מיום החשבונית (עד 250 תווים )	הערות למסמך - יודפסו במסמך למטה
12	IsVatFree	true = מע"מ 0 False = מע"מ 18	האם המסמך כולו הוא ללא מע"מ - מתאים ללקוח חו"ל
13	DepartmentId	123 (int)	קוד מחלקה להצגה בדוחות והעברה להנח"ש ראה הגדרת המחלקות במסוף : מיון מסמכים ושימוש במחלקות
14	AdvancedDefinition אובייקט עם פרמטרים בתוכו.	IsAutoCreateUpdateAccount (bool) - false - כל הלקוחות ירשמו על "לקוחות שונים". true - יפתח כרטיס לקוח לכל עסקה , ומידה וקים יבוצע שיוך ללקוח לפי ההסבר. ------------------------------ AccountForeignKey (string) - לדוגמא 300 ------------------------------ SiteUniqueId (string) ------------------------------ AccountID (integer) - 123 ------------------------------ IsLoadInfoFromAccountID (boolean) - true \ false	IsAutoCreateUpdateAccount (bool) - האם ליצור ללקוח כרטיס לקוח במערכת. מצב זה חובה להעביר את פרמטר: InvoiceHead.CompID - ת.ז. / ח.פ. של הלקוח. אם הלקוח כבר קיים לא יפתח כרטיס חדש. במידה ולא מועבר יתבצע איתור לפי מפתח זר ולאחר מכן לפי מזהה ייחודי אתר ואז לפי EMAIL לקוח. (הפרמטר הראשון שנמצע בשרת מוצלב ולא ממשיך לחפש עוד ) ------------------------------ AccountForeignKey (string) - מספר מפתח זר של הלקוח - פעיל רק אם יוצר ללקוח כרטיס לקוח. (מספר הנח"ש) ------------------------------ SiteUniqueId (string) - מזהה ייחודי לאתר - פרמטר אינפורמטיבי. (מזהה נוסף) ------------------------------ AccountID (integer) - 123 - מספר הלקוח במערכת אישורית זהב לשיוך המסמך (לא פעיל בעסקה מושהית ) ------------------------------ IsLoadInfoFromAccountID (boolean) - אם יש AccountID. אפשר לקחת מהכרטיס לקוח שמשויך למספר לקוח את הנתונים ולהכניס אותם למסמך.
15	Products מערך עם אובייקטים בתוכו.	ProductID (string) - ZZASA AASSA - 12 ------------------------------ Description (string) - קורס אינטרנטי ------------------------------ Quantity (integer) - 2 ------------------------------ UnitCost (integer) - 50.57 ------------------------------ TotalLineCost (integer) - 51 ------------------------------ IsVatFree (boolean) - true \ false	ProductID (string) - קוד פריט , מק"ט , קוד מוצר - מומלץ להעביר לשם דוחות , ניתן לראות ב דוח פריטים במסמך במקרה של שני פריטים ניתן להפריד כך: InvoiceLines1.ProductID=AAA InvoiceLines2.ProductID=BBB ------------------------------ Description (string) - תיאור המוצר ------------------------------ Quantity (integer) - כמות הפריטים בהעברה של כמות מעל 1 , יש להכפיל במחיר ולשלוח אמצעי תשלום מתאים. ------------------------------ UnitCost (integer) - מחיר יחידה. -----------------------------TotalLineCost (integer)- מומלץ במקרה וכמות המוצרים הוא מספר לא שלם. זה יכול למנוע בעיות עיגול מחיר. ----------------------------- IsVatFree (boolean) - האם המוצר הזה יהיה עם מע''מ או בלי מע''מ.
16	ExternalId	(String)	מזהה מערכת חיצוני ברמת מסמך בלבד (לא נשמר ברמת כרטיס לקוח)
17	ManualNumber	585177	מספור ידני של המסמך. ניתן לשימוש רק ביצירת מסמך ללא חיוב. יש לבקש הרשאה מיוחדת לשימוש בפרמטר זה. ראה הערות בסוף המאמר. במקרים נדירים ניתן להעביר את מספר החשבוניות שהמערכת תיצור במקום להשתמש במונה הפנימי של המערכת. שם לב! במידה וישנה התנגשות במונים החשבונית לא תיוצר , יש לבקש הרשאה מיוחדת לשימוש בפרמטר זה.
18	DocumentDateDDMMYYYY	"05/03/2025"	תאריך הפקת מסמך.
19	ValueDate	"12/03/2025"	תאריך ערך של המסמך (נועד להפקדות יומן)
20	Languge	"he" \ "en"	שפת מסמך
21	IsSendSMS	boolean - true \ false	האם לשלוח את המסמך בסמס? (דורש מודל סמס)

RESPONSE של Do Transaction.

לאחר ששולחים POST לפונקציה זאת יתקבלו הערכים הבאים בRESPONSE:

מספר	שם פרמטר	ערכים אפשריים לדוגמא	תיאור
1	ResponseCode	0	0 - הפעולה תקינה ,אחרת שגוי - שגיאת פיתוח.
2	Description	"העסקה בוצעה בהצלחה"	תיאור התשובה , במידה ומתקבל תשובה שונה, העסקה לא בוצעה בהצלחה.
3	TranzactionId	654354685	מספר ייחודי של עסקה שבוצעה בעת חיוב אשראי. גודל התשובה יכול להיות Int64/ BigInt
4	TerminalNumber	1001	מספר מסוף
5	Amount	100.50	הסכום לחיוב.
6	CoinId	1 - שקל 2 - דולר לקודי מטבע נוספים - רשימת קודי מטבעות	מטבע לחיוב העסקה.
7	CouponNumber	38022395	מספר שובר של הפתקית. לפעמים יכול לשמש להתאמות
8	CreateDate	"2025-03-12T08:46:45"	תאריך יצירת עסקה
9	Last4CardDigits	5796	ארבע ספרות אחרונות של אשראי INT
10	Last4CardDigitsString	"5796"	ארבע ספרות אחרונות של אשראי string
12	FirstCardDigits	440066	שש ספרות ראשונות.
13	JParameter	0 - ברירת מחדל לפי הגדרות חברות האשראי. 2 - בדיקה בלבד של ספרת ביקורת 5 - קבלת אישור מול חברות האשראי	J- פרמטר , סוג בדיקה לביצוע על הכרטיס
14	CardMonth	12	חודש כרטיס
15	CardYear	2021	שנת כרטיס
16	ApprovalNumber	009491B	מספר אישור. חיוני במקרה של J5. אם יש J5 והבית עסק ירצה לחייב מאוחר יותר את מסגרת התפוסה, המספר אישור, יהיה חיוני לחיוב המסגרת.
17	FirstPaymentAmount	50.00	סכום תשלום הראשון
18	ConstPaymentAmount	20.00	סכום מספר התשלומים הנוספים
19	NumberOfPayments	5	מספר התשלומים
20	CardInfo	"Israeli" "NonIsraeli" "FuelCard" "ImmediateChargeCard" "GiftCard"	סוג הכרטיס
21	CardOwnerName	"daniel"	שם בעל הכרטיס
22	CardOwnerPhone	"0522222222"	מספר טלפון של בעל הכרטיס
23	CardOwnerEmail	"test@gmail.com"	אימייל בעל הכרטיס
24	CardOwnerIdentityNumber	"213654987"	מספר תעודת זהות
25	Token	"4cf8e168-261e-4613-8d20-000332986b24"	מספר האסימון, חוה לשמור בבסיס הנתונים.
26	CardName	"ויזה רגיל"	שם כרטיס
27	SapakMutav	1234	מספר לקוח בעבודה ברב מוטב
28	Uid	"21121517002429612920744"	מזהה עסקה יחודי. אם עושים זיכוי \ חיוב מחוץ לעסקה, למשל כעסקה חדשה עם אסימון, הUID יהיה חדש ושונה מהעסקה המקורית.
29	ConcentrationNumber	מספר ריכוז.	מספר הפקדה / ריכוז
30	DocumentNumber	300394	מספר מסמך
31	DocumentType	"Auto" - אוטומטי, לפי מה שיש בהגדרות 3->4. "TaxInvoiceAndReceipt" – חשבונית מס וקבלה "TaxInvoiceAndReceiptRefund" – חשבונית זיכוי והחזר כספים "Receipt" – קבלה מלכ''ר "ReceiptRefund" – קבלה מלכ"ר זיכוי ( החזר כספים) "Quote" – הצעת מחיר "Order" – הזמנה "OrderConfirmation" – אישור הזמנה - מאתר "OrderConfirmationRefund" – זיכוי אישור הזמנה - מאתר "DeliveryNote" – תעודת משלוח "DeliveryNoteRefund" – תעודת החזרה "ProformaInvoice" – חשבון עסקה "DemandForPayment" – דרישה לתשלום "DemandForPaymentRefund" – ביטול דרישה לתשלום "ProformaDealInvoice" – חשבון קבלה פרופורמה "ProformaDealInvoiceRefund" –חשבון קבלה זיכוי "TaxInvoice" – חשבונית מס "ProformaInvoiceRefund" – זיכוי חשבון עסקה "TaxInvoiceRefund" – חשבונית מס זיכוי "ReceiptForTaxInvoice" – קבלה (לחשבונית) "DonationReceipt" – קבלה על תרומה "DonationReceiptRefund" – זיכוי קבלה תרומה (החזר כספים) "ReceiptForTaxInvoiceRefund" – החזר כספים לקוחות (קבלה זיכוי)	סוג מסמך
32	Rrn	"500301575449"	מספר זיהוי אצל חברות האשראי
33	Brand	"PrivateCard" "MasterCard" "Visa" "Maestro" "AmericanExpress" "Isracard" "JBC" "Discover" "Diners"	מותג כרטיס
34	Acquire	"Unknown" "Isracard" "CAL" "Diners" "AmericanExpress" "Laumicard" "CardCom" "PayPal" "Upay" "PayMe"	חברה סולקת
35	Issuer	"NonIsrael" "Isracard" "CAL" "Diners" "AmericanExpress" "JCB" "Laumicard"	חברה מנפיקה
36	PaymentType	"Unknown" "Standard" "SpecialCredits" "ImmediateCharge" "CreditClub" "SuperCredit" "InstallmentCredit" "Payments" "ClubPatments"	סוג אשראי - חיוב רגיל \ תשלום \ קרדיט \ ניכיון
37	CardNumberEntryMode	"MagneticStip" "SelfService" "GasStationSelfService" "Contactless" "EmvContactless" "MobileContactless" "EmvMobileContactless" "MobileNumber" "Emv" "Phone" "SignatureOnly" "Internet" "Fallback" "EmptyCandidateList"	מקור עסקה - אינטרנטית \ EMV \ טלפונית...
38	DealType	"Information" "Debit" "Discharge" "ForcedCharge" "CashBack" "CashTransaction" "Recurring" "BalanceQuery" "Cancel" "Refund" "Recharge"	סוג + מקור עסקה - ביטול \ חיוב \ הוראת קבע \ זיכוי
39	IsRefund	boolean - true \ false	האם זו הייתה עסקה זיכוי
40	DocumentUrl	נותן את הURL של המסמך	נותן את הURL של המסמך
41	CustomFields מערך של אובייקטים.	Id - 20 Value - "value"	הערכים של השדות המותאמים אישית.
42	IsAbroadCard	boolean (true\false)	האם הכרטיס הוא כרטיס מחו''ל?

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

חיוב אסימון שנוצר בשלב 1:

{
"TerminalNumber": 1001,
"ApiName": "test2025",
"Amount": 200,
"Token": "4cf8e168-261e-4613-8d20-000332986b24",
"CardExpirationMMYY": "0628",
"ExternalUniqTranId": "h7rZ3#קV3Tp!7kLb0wUeG3zC",
"ExternalUniqUniqTranIdResponse": false,
"NumOfPayments": 1
}

חיוב אסימון שנוצר בשלב 1 והפקת מסמך:

{
"TerminalNumber": 1001,
"ApiName": "test2025",
"Amount": 200,
"Token": "4cf8e168-261e-4613-8d20-000332986b24",
"CardExpirationMMYY": "0628",
"ExternalUniqTranId": "h7rZ3#קV3Tp!7kL-b0wUeG3zC",
"ExternalUniqUniqTranIdResponse": false,
"NumOfPayments": 1,
"Document": {
"DocumentTypeToCreate": "TaxInvoiceAndReceipt",
"Name": "תעבוד",
"TaxId": "040617640",
"Email": "test@gmail.com",
"IsSendByEmail": false,
"IsVatFree": false,
"Products": [
{
"Description": "hey",
"Quantity": 1,
"UnitCost": 200
}
]
}
}

חיוב מסגרת שנתפסה בשלב 1:

{
"TerminalNumber": 1001,
"ApiName": "test2025",
"Amount": 200,
"Token": "4cf8e168-261e-4613-8d20-000332986b24",
"CardExpirationMMYY": "1225",
"ExternalUniqTranId": "h7rZ3#קV3Tp4!76-kLb0wUeG3zC",
"ExternalUniqUniqTranIdResponse": false,
"NumOfPayments": 1,
"Advanced": {
"ApprovalNumber": 204394904
}
}

חיוב מסגרת שנתפסה בשלב 1 והפקת מסמך:

{
"TerminalNumber": 1001,
"ApiName": "test2025",
"Amount": 200,
"Token": "4cf8e168-261e-4613-8d20-000332986b24",
"CardExpirationMMYY": "1225",
"ExternalUniqTranId": "h7rZ3#קV3Tp4!76-kLb0wUeG3zC",
"ExternalUniqUniqTranIdResponse": false,
"NumOfPayments": 1,
"Advanced": {
"ApprovalNumber": 204394904
},
"Document": {
"DocumentTypeToCreate": "TaxInvoiceAndReceipt",
"Name": "תעבוד",
"TaxId": "040617640",
"Email": "test@gmail.com",
"Products": [
{
"Description": "hey",
"Quantity": 1,
"UnitCost": 30
}
]
}
}

שחרור מסגרת שנתפסה בשלב 1:

{
"TerminalNumber": 1001,
"ApiName": "test2025",
"Amount": 200,
"Token": "4cf8e168-261e-4613-8d20-000332986b24",
"CardExpirationMMYY": "1225",
"ExternalUniqTranId": "h7rZ3#קV3Tp4!76-kLb0wUeG3zC",
"ExternalUniqUniqTranIdResponse": false,
"NumOfPayments": 1,
"Advanced": {
"ApprovalNumber": 204394904,
"MTI": 420
}
}

חיוב אשראי (ממשק ישיר):

{
"TerminalNumber": 1001,
"ApiName": "test2025",
"Amount": 200,
"CardNumber": "4580000000000000",
"CardExpirationMMYY": "0628",
"CVV2": "569",
"ExternalUniqTranId": "h7rZs#4V3Tp!7kLb0wUeG3zC",
"ExternalUniqUniqTranIdResponse": false,
"NumOfPayments": 1
}

חיוב אשראי והפקת מסמך:

{
"TerminalNumber": 1001,
"ApiName": "test2025",
"Amount": 200,
"CardNumber": "4580000000000000",
"CardExpirationMMYY": "0628",
"CVV2": "569",
"ExternalUniqTranId": "h7rZs#4V3Tp!7kLb0wUeG3zC",
"ExternalUniqUniqTranIdResponse": false,
"NumOfPayments": 1,
"Document": {
"DocumentTypeToCreate": "TaxInvoiceAndReceipt",
"Name": "בדיקה",
"TaxId": "040617640",
"Email": "t@t.com",
"IsSendByEmail": false,
"IsVatFree": false,
"Products": [
{
"Description": "מוצר בדיקה",
"Quantity": 1,
"UnitCost": 200
}
]
}
}

שלב 3 - חיוב של אסימון \ תפיסת מסגרת \ חיוב פרטי אשראי בממשק ישיר. (Do Transaction)

מתי להשתמש בפונקציה זו?

מה זה "ממשק ישיר"?

תהליך החיוב בממשק ישיר.

פעולות נפוצות בפונקציה "Do Transaction".

דרישות & מודלים נחוצים.

שלב שלוש - חיוב אסימון & חיוב פרטי אשראי - Do Transaction.

להלן קישור לפונקציה בJSON.

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

האם המאמר הזה עזר לך?