# IFrame / טופס ישיר
# מבוא
שתי האינטגרציות דומות מאוד, ההבדל המעשי בינהן הוא כאשר אינטגרציה דרך אייפריים מעבירה רק את הדומיין של האייפריים לדף התשלום ואילו האינטגרציה של הפורום מעבירה את כל האתר לדף התשלום.
ברגע שליחת הטופס/ אייפריים הלקוח מועבר לדף תשלום מאובטח של נאייקס.
# דוגמאות
רשימת פרמטרים ושדות חובה יופיעו בצד ימין בתפריט.
הדוגמא הבאה ממחישה היבט אחד בשלבי הטרנזקציה:
- תחילת טרנזקציה באתר של בעל העסק
- הלקוח שולח את הפורום באתר בעל העסק
- בעל העסק מקבל את פרטי הטרנזקציה באתר שלו ומוסיף להם חתימה ופרטים נדרשים נוספים
- לאחר שליחת הפורום לשרתי נאייקס, הלקוח מועבר לדף תשלום מאובטח
- הלקוח מסיים את הטרנזקציה בדף של נאייקס בהצלחה או כישלון
- נאייקס מעבירים את הלקוח בחזרה לדף אשר בעל העסק הגדיר או דרך api או דרך הדאשבורד שלו
הדוגמא מטה היא דוגמא מינמלית לטופס שלקוח ממלא באתר בעל העסק. רשימת הפרמטרים לשליחה ל api של נאייקס תינתן מצד ימין בתפריט. ישנם עוד פרמטרים רבים שניתן לשלוח.
אופן השימוש: הלקוח ממלא את הפרטים אצל בעל העסק ןשולח את הטופס, בעל העסק מקבל את הפרטים וממיר אותם ל api של נאייקס ומוסיף למשל, אופציה לתשלומים, ויזה או מאסטרכארד וכו׳.
ניתן להשתמש ב sdk של נאייקס הכתוב בכמה שפות על מנת לבצע טרנזקציות או להתחבר ללא ה sdk עם דוגמאות ומידע על ה api.
# פרמטרים לאינטגרציה של דף תשלום מאובטח
| שדה | תיאור | גודל מקסימלי | האם שדה חובה |
|---|---|---|---|
| merchantID | מספר העסק במערכת של נאייקס | 7 | כן |
| trans_amount | סכום הטרנזקציה | 20 | כן |
| trans_currency | מטבע הטרנזקציה, רשימת מטבעות בצד ימין | 3 | כן |
| trans_type | 0 = חיוב מידי 1 = אישור בלבד | 1 | כן |
| trans_installments | תשלומים | 2 | כן |
| trans_refNum | מזהה פנימי של בעל העסק אצלו במערכת | 100 | לא |
| trans_comment | הערות של בעל העסק לטרנזקציה | 255 | לא |
| trans_storePm | 1 בשביל לשמור את הכרטיס לטרנזקציות הבאות | 1 | לא |
| disp_payFor | הודעת תשלום - כלומר על מה התשלום - שהלקוח רואה בדף | 40 | לא |
| disp_paymentType | שיטת התשלום, כרטיס אשראי, sofort ועוד שיטות אחרות, רשימה מצד ימין | 80 | לא |
| disp_lng | שפת דף התשלום, ברירת המחדל היא מה שבעל העסק קבע או הפרמטר הזה, רשימה קיימת בצד ימין | 5 | לא |
| notification_url | url שמשמש את נאייקס להודיע לבעל העסק על מצב התשלום ניתן להגדיר בשתי אופנים, דאשבורד בעל העסק או הפרמטר הזה | 255 | לא |
| url_redirect | url שמשמש את נאייקס להפניה בסוף הטרנזקציה ניתן להגדיר בשתי אופנים, דאשבורד בעל העסק או הפרמטר הזה | 255 | לא |
| skin_no | איזה דף תשלום להציג ניתן להגדיר בדאשבורד של נאייקס | 2 | לא |
| signature | החתימה הנדרשת על מנת לזהות את הטרנזציה ומקורה במערכות של נאייקס | 30 | כן |
כמו כן, ניתן למלא מספר שדות מראש כך שבעת השליחה לשרתים של נאייקס, דף התשלום יכיל שדות שמולאו מראש.
# שדות ממולאים מראש
| שדה | תיאור | גודל מקסימלי | האם שדה חובה |
|---|---|---|---|
| client_fullName | שם מלא של בעל הכרטיס | 50 | לא |
| client_email | כתובת מייל | 50 | לא |
| client_phoneNum | מספר טלפון לקוח | 15 | לא |
| client_idNum | מספר זהות לקוח | 9 | לא |
| client_billAddress1 | שדה כתובת חיוב לקוח 1 | 50 | לא |
| client_billAddress2 | שדה כתובת חיוב לקוח 2 | 50 | לא |
| client_billCity | שדה עיר לקוח | 20 | לא |
| client_billZipcode | שדה מיקוד לקוח | 20 | לא |
| client_billState | שדה מדינת לקוח, מורכב מ iso code עם 2 אותיות | 2 | לא |
| client_billCountry | שדה ארץ לקוח, מורכב מ iso code עם 2 אותיות | 2 | לא |
# רשימת מטבעות
- ILS = Israel New Shekel
- USD = US Dollar
- EUR = Euro
- GBP = UK Pound Sterling
- AUD = Australian Dollar
- CAD = Canadian Dollar
- JPY = Japanese Yen
- NOK = Norwegian Krone
- PLN = Polski Zloty
- MXN = Mexican Peso
- ZAR = South African Rand
- RUB = Russian Ruble
- TRY = Turkish Lira
- CHF = Swiss Franc
- INR = Indian Rupee
- DKK = Danish Krone
- SEK = Swedish Krona
- CNY = Chinese Yuan
- HUF = Hungarian Forint
- NZD = New Zealand Dollar
- HKD = Hong Kong Dollar
- KRW = South Korean Won
- SGD = Singapore Dollar
- THB = Thai Baht
- BSD = Bahamian Dollar
# רשימת שפות דף תשלום
- he-IL = עברית (ישראל)
- en-US = English (United States)
- fr-FR = Français (France)
- es-ES = Español (España, alfabetización internacional)
- lt-LT= Lietuvių (Lietuva)
- ru-RU = русский (Россия)
- de-DE = Deutsch (Deutschland)
- zh = 中文
# שיטות תשלום זמינות
| מזהה | שם | קוד במערכת |
|---|---|---|
| 0 | Other | OP |
| 1 | Credit Card | CC |
| 2 | ACH (Electronic Checks) | EC |
| 3 | Instant Online Bank Transfer | ID |
| 4 | European Direct Debit | DD |
| 6 | Micropay | PD |
| 7 | Online Bank Transfer | OB |
| 8 | Wallet | CS |
| 9 | Prepaid | PP |
| 10 | External prepaid | EP |
# חישוב שדה החתימה
SHA256 הינו האלגוריתם המשמש לוידוא הנתונים הנשלחים. להלן דוגמאות כיצד יש לחשב את שדה זה וב sdk ניתן למצוא דוגמאות במגוון שפות כיצד לבצע זאת.
דרך עבודת האלגוריתם: יש לצרף את כל הערכים של השדות שהלקוח מילא ואתה בתור בעל העסק המרת והוספת לשדה אחד גדול, שהסוף שלו מכיל את הסיסמא שקיבלת מנאייקס.
יש להשתמש באלגוריתם SHA256 על מנת להמיר את השדה לקוד מסויים, לאחר זאת יש לבצע המרה נוספת של Base64 על התוצאה שהופיע מקודם.
פן נוסף בו יש להתחשב בעת הפניית הלקוח ישירות לדף של נאייקס : נדרשת המרה על השדה הנ״ל URL Encode על השדה לפני שאתה שולח אותו לנאייקס.
דוגמא:
- CompanyNum = 1234567
- TransType = 1
- TypeCredit = 1
- Amount = 5.4
- Currency = 1
- CardNum = 4580000000000000
- RefTransID = 1234
- PersonalHashKey = AU7E468HNF
CompanyNum + TransType + TypeCredit + Amount + Currency + CardNum + RefTransID + PersonalHashKey "1234567" + "1" + "1" + "5.4" + "1" + "4580000000000000" + "1234" + "AU7E468HNF"
Base64(SHA256("1234567115.4145800000000000001234AU7E468HNF")) Result: "PTpzX9OACBC+V3Fd9+TNCehnwIfqMaXmnUtsZMSRyVo="
שים לב
אם הינך עושה שימוש ב GET- ולא ב POST- עליך לבצע URL Encoding מאחר והתוצאה מהחתימה תהיה עם סימנים של + וסימנים נוספים שהדפדפן ממיר ולכן ההמרה נדרשת.
דוגמאות ליצירת חתימה
שימוש: