יצירת כרטיס לקוח באמצעות ממשק 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

דוגמא לפנייה בסיסית:

https://secure.cardcom.solutions/interface/RecurringPayment.aspx?TerminalNumber=1000&UserName=test2025&Operation=NewAndUpdate&codepage=65001&Account.CompanyName=yuvalTest&Account.RegisteredBusinessNumber=20000000

תשובה מהשרת:

ResponseCode=0&Description=OK&TotalRecurring=0&IsNewAccount=True&AccountId=11325

מאמרים בקטגוריית המשנה הזאת

מאמרים קשורים