יצירת כרטיס לקוח באמצעות ממשק API
יצירת כרטיס לקוח באמצעות ממשק API
בעדכון יש לשלוח רק את השדות שרוצים לעדכן.
ממשק Name to Value
https://secure.cardcom.solutions/interface/RecurringPayment.aspx
-
התשובה המתקבלת היא במבנה :Name=Value&Name2=Value2&Name3=Value3.
ממשק Web Service
https://secure.cardcom.solutions/Interface/BillGoldService.asmx
פעולה:
https://secure.cardcom.solutions/Interface/BillGoldService.asmx?op=AddUpdateRecurringOrder
מקרא:
פרמטר אדום - חובה
פרמטר מודגש - מומלץ
פרמטר לא אדום ולא מודגש - אופציונלי
טבלת פרמטרים:
| מס | פרמטר | תיאור | ערכים אפשריים לדוגמה |
|---|---|---|---|
| 1 | TerminalNumber | מספר הטרמינל הפנימי באתר, לא מספר מסוף שבא | 1000 |
| 2 | UserName | שם משתמש ממשקים | usertest |
| 3 | Operation | NewAndUpdate - הוסף לקוח/ הוראה לחיוב חדש. אם לקוח לא נמצא ייוצר לקוח חדש. Update - עדכון בלבד של לקוח/ הוראה - אם לא נמצה תוחזר שגיאה. |
NewAndUpdate - הוסף חדש אם קיים עדכן. Update - עדכן בלבד. |
| 4 |
codepage |
קידוד עברית - unicode | 65001 |
| 5 | LowProfileDealGuid | קוד הפרופיל נמוך של עסקת החיוב הראשונה של הלקוח החדש שחויב בפרופיל נמוך (דרך פרמטר זה נלקח הפרטי אשראי של הלקוח) | 72183f28-75fa-404e-b5de-5a1a5287f094 |
| 6 | Account.AccountId | מזהה יחוד של לקוח - יש להעביר בעדכון בלבד. | 123 |
| 7 | Account.CompanyName | שם הלקוח / שם החברה שעליה תצא החשבונית | Test Company |
| 8 | Account.RegisteredBusinessNumber | מספר ח.פ / עוסק מורשה / ת.ז לקוח (מומלץ להעביר) | 040617649 |
| 9 | Account.SiteUniqueId | מספר לקוח ייחודי במערכת שלכם. | 0406176491 |
| 10 | Account.FirstName | שם פרטי (עדיף להשאיר ריק ולהעביר שם מלא ב Account.CompanyName ) | eli |
| 11 | Account.City | מקום / עיר | holon |
| 12 | Account.Street1 | כתובת שורה 1 (רחוב) | Street 1 |
| 13 | Account.Street2 | כתובת שורה 2 (רחוב) | Street 2 |
| 14 | Account.ZipCode | מיקוד | 12345 |
| 15 | Account.PhLine | טלפון נייח | 040617649 |
| 16 | Account.PhMobile | נייד | 039619611 |
| 17 | Account.Email | כתובת דואר אלקטרוני - Email | DemoEmail@Site.co.il |
| 18 | Account.ForeignAccountNumber | מספר הנהלת חשבונות של לקוח ספציפי (לא חובה) | 54172 |
| 19 | Account.VatFree | הקמת לקוח ללא מע"מ (ללקוחות חו"ל / אילת ) | true |
| 20 | Account.IsDocumentLangEnglish | שפת מסמך שיופק ללקוח באנגלית (ללקוחות חו"ל) | true |
| 21 | Account.Comments | הערות לחשבון הלקוח | "לקוח שילם במזומן בסוף" |
| 22 | Account.ContactName |
שם איש קשר | avi |
אמצעי תשלום אשראי:
| מספר |
פרמטר |
תיאור | ערכים אפשריים לדוגמה |
| 1 |
CreditCard.CardOwnerName |
שם בעל הכרטיס | eli cohen |
| 2 |
CreditCard.CardOwnerId |
תעודת זהות בעל הכרטיס | 123456789 |
| 3 |
CreditCard.Year |
תוקף שנה | YY |
| 4 |
CreditCard.Month |
תוקף חודש | MM |
| 5 |
CreditCard.Token Or CreditCard.Number |
טוקן הכרטיס או מספר אשראי (לא תומך תקן PCI)* |
4cf8e168-261e-4613-8d20-000332986b24 |
או
אמצעי תשלום בנקאי (מס"ב):
| מספר | פרמטר | תיאור | ערכים אפשריים לדוגמה |
| 1 | BankInfo.Bank | מספר בנק | 1 ( INT ) |
| 2 | BankInfo.Branch | מספר סניף | 123 (INT ) |
| 3 | BankInfo.AccountNumber | מספר חשבון בנק | 1233456 (LONG) |
| 4 | BankInfo.Description | הערות כלליות | מחרוזה 50. |
קבלת תשובה לעסקה בהצלחה
| מספר | פרמטר | תיאור | ערכים אפשריים לדוגמה |
| 1 | ResponseCode | האם הצליח - 0 תקין, אחרת תהיה שגיאה בתיאור מלל |
0 |
| 2 | Description | תיאור השגיאה אם יש, או תקין. |
OK |
| 3 | AccountId | מספר הלקוח שהוקם במערכת של קארדקום |
1005 |
דוגמא לפנייה בסיסית:
תשובה מהשרת:
ResponseCode=0&Description=OK&TotalRecurring=0&IsNewAccount=True&AccountId=11325