CompanyOperations - פונקציה לפתיחת חברה בקארדקום. (New company)
מתי להשתמש בפונקציה זו?
פונקציה זו נועדה לדילרים או ספקים אשר רוצים להוסיף בית עסק חדש תחתם.
להלן קישור לפונקציה בJSON.
https://secure.cardcom.solutions/api/v11/CompanyOperations/NewCompany
להלן הפרמטרים שצרים להעביר בפונקציה .
מקרא:
פרמטר אדום - חובה
פרמטר מודגש - מומלץ
פרמטר לא אדום ולא מודגש - אופציונלי
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | SupplierUserName | (String) | שם משתמש של הספק. |
| 2 | SupplierPassword | (String) | סיסמה של הספק. |
| 3 | Secret | (String) | סוד |
| 7 | TerminalInfo - אובייקט |
BankCode - (String) ---- BankBranchCode - (String) ---- BankAccountNumber - (String) ---- ModuleList מערך של פרמטר ModuleID |
BankCode - קוד בנק. ---- BankBranchCode - קוד סניף. BankAccountNumber - מספר חשבון בנק. ---- ModuleList - מערך של קודי מודל לפתיחה. |
ערכים של אובייקט CompanyInfo (4).
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | Activity | (String) | תחום פעילות העסק |
| 2 | BusinessRegistrationNumber | (String) | מספר ח.פ / עוסק / ת.ז |
| 3 | ContactPerson | (String) | איש קשר. |
| 4 | (String) | אימייל בית עסק. | |
| 5 | Name | (String) | שם בית עסק. |
| 6 | Fax | (String) | פקס בית עסק. |
| 7 | PhoneNumber | (String) | טלפון קווי. |
| 8 | MobilePhone | (String) | טלפו נייד. |
| 9 | ZipCode | (String) | מיקוד. |
| 10 | IsVatFreeCompany | Boolean - true \ false | האם בית עסק עוסק פטור ? |
| 11 | Citizenship |
|
אזרחות של הבית עסק. |
| 12 | CompanyInternalID | (String) | מספר חברה שנפתח בקארדקום. |
| 13 | NameEng | (String) |
שם הבית עסק באנגלית. ללקוחות עם 3DS שדה חובה. |
| 14 | CityCode | (Int) | קוד עיר. |
|
15 |
StreetCode | (Int) | קוד רחוב. |
| 16 | HouseNumber | (String) | מספר בית. |
| 17 | WebSiteUrl | (String) | כתובת URL של האתר בית עסק. |
| 18 | Entrance | (String) | כניסה |
| 19 | CountryCode | (Int) | קוד מדינה. |
| 20 | NameLegalCorporation | (String) | שם בית העסק המשפטי |
| 21 | AgreementInfo - אובייקט | AgreementId - (Int) | מספר ההסכם של הספק מול קארדקום, ייחודי פייר ספק. |
ערכים של אובייקט UserInfo (5).
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | StreetCode | (Int) | Get streets |
| 2 | CityCode | (Int) | קוד עיר. |
| 3 | (String) | אימייל בית עסק. | |
| 4 | IdentityNumber | (String) | מספר ת''ז. |
| 5 | LogInName | (String) | שם משתמש לכניסה למערכת של קארדקום. |
| 6 | LogInPassword | (String) | סיסמת לכניסה למערכת של קארדקום. |
| 7 | FirstName | (String) | שם פרטי של בעל העסק. |
| 8 | Fax | (String) | פקס בית עסק. |
| 9 | PhoneNumber | (String) | מספר טלפון קווי של בית העסק. |
| 10 | MobilePhone | (String) | מספר טלפון נייד. |
| 11 | ZipCode | (String) | קוד מיקוד. |
| 12 | LastName | (String) | שם משפחה. |
| 13 | BirthDate | (String) | תאריך לידה. |
| 14 | Gender | Unknown" "male" "female" Enum" | מגדר. |
| 15 | IdentityIssueDate | (String) | תאריך הנפקת ת''ז. |
| 16 | PassportIssueCountryCode | (Int) | קוד מדינת הוצאת הדרכון. |
| 17 | IdIssueDateOrPassportIDTypes | "IDNumber" "Passport" | תאריך הנפקת הדרכון. |
| 18 | PersonalIdentificationCode | (String) | מספר דרכון. |
ערכים של KycInfoGeneric (8.1).
אובייקט מקונן של KycInfo.
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | CountriesTargetedMarket | (String) | טקסט חופשי עד 250 תווים, עבור איזה מדינות המוצר מיועד , ניתן כמה ערכים |
| 2 | NamesOfRelatedBusinesses | (String) | טקסט חופשי עד 250 תווים, רשימת העסקים הקשורים – כמו חברת בת . המשך לשדה הקודם במידה וסימנו בו TRUE |
| 3 |
ExpectedPercentage PaymentOfOnePayment |
(Number) | אחוז העסקאות צפוי של תשלום בודד אחד |
| 4 |
ExpectedPercentageOf PaymentTransactions |
(Number) | אחוז עסקאות צפוי של עסקאות תשלומים |
| 5 |
ExpectedPercentageOf CreditPaymentTransactions |
(Number) | אחוז עסקאות צפוי של תשלומי קרדיט |
| 6 |
ExpectedPercentageOf TouristTransactions |
(Int) | אחוז עסקאות צפוי של עסקאות תייר |
| 7 |
ExpectedPaymentNumber ForAverageTransaction |
(Int) | הצפי לעסקה ממוצעת מבחינת מספר תשלומים. שדה שמקבל מספר שלם |
| 8 | SalePlatform |
(String) -
|
באיזה פלטפורמה המכירה צפויה להתבצע - לא בשימוש שדה שמקבל מספר שלם |
| 9 | SalePlatforms - מערך של (String) |
[(String),(String)] שלמים מהצורה Enum: |
באיזה פלטפורמות המכירות צפויות להתבצע |
| 10 | IsPaymentsFacilitator | Boolean - true \ false |
ריכוז חיובים של ספקים אחרים – האם הלקוח הוא לקוח מאגד |
| 11 | IsBusinessFacilitateCashWithdrawls | Boolean - true \ false | האם הלקוח מאפשר משיכת מזומן בקופה? |
| 12 |
IsBusinessFacilitateVoucherOr RechargingCardsSales |
Boolean - true \ false | האם הלקוח מאפשר מכירת שוברים/כרטיסים נטענים/כרטיסי מתנה? |
| 13 |
IsBusinessFacilitateCreditFor TransactionsOutsideBusinessScope |
Boolean - true \ false | האם הלקוח נותן אשראי שלא למטרת קנייה בחנות? |
| 14 |
IsBusinessPlaceCash RegistersInOtherBusinesses |
Boolean - true \ false | הצבת קופות בבתי עסק אחרים? |
| 15 | TypeOfPlannedService | (String) | מה הוא סוג השירות המתוכנן? שדה פתוח עד 250 תווים. |
| 16 | MinimumAmountOfCreditTransaction | (Int) | מהו הסכום המינימלי לעסקה בכרטיס אשראי? |
| 17 | MaximumAmountOfCreditTransaction | (Int) | מהו הסכום המקסימלי לעסקה בכרטיס אשראי? |
| 18 | IsTheBusinessSeasonal | Boolean - true \ false | האם העסק בעיקר פועל בעונה מסוימת של השנה? |
| 19 |
IsTheBusinessPreviously ClearedCreditCards |
Boolean - true \ false | האם העסק סלק בעבר כרטיסי אשראי ? |
| 20 |
NumberOfYearsBusiness HasInClrearance |
(Int) | כמה שנות ניסיון יש לעסק בתחום הסליקה? |
| 21 |
ExpectedStoreSupply DeliverySchedule |
(String)
|
משך זמן האספקה הצפוי למוצרי החנות? |
| 22 | TimeTillProductShips | (Int) | משך זמן האספקה הצפוי למשלוח? |
| 23 |
AvarageTransaction AmountInCreditCard |
(Int) | מהו הסכום הממוצע לעסקה בכרטיס אשראי? |
| 24 |
EstimatedMonthly TransactionAmount |
(Int) | מספר עסקאות חודשי משוער |
| 25 |
IsBusinessBeenDeniedAction VersusBankingCorporation |
Boolean - true \ false | האם בית עסק סורב בעבר לפעילות אל מול תאגיד בנקאי |
| 26 | GeneralBusinessFieldMccCode | (Int) | תחום עיסוק כללי |
| 27 | SpecifiedBusinessFieldMccCode | (Int) | תחום עיסוק מפורט |
| 28 | TypeOfRecruitment |
(String)
|
דרך הגיוס |
ערכים של KycInfoOsekMurshe (8.2).
אובייקט מקונן של KycInfo.
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 |
IsOwnerAddressDifferent FromBusinessAddress |
Boolean - true \ false | האם כתובת המגורים של הבעלים שונה מכתובת העסק |
| 2 | BusinessOwnerHomeNumber | (String) | מספר הבית בכתובת המגורים של בעל בית העסק |
| 3 | BusinessOwnerEntranceNumber | (String) | כניסה בכתובת המגורים של בעל בית העסק |
| 4 | BusinessOwnerStreetCode | (Int) | קוד רחוב בכתובת המגורים של בעל בית העסק |
| 5 | BusinessOwnerCityCode | (Int) | קוד עיר בכתובת המגורים של בעל בית העסק |
| 6 | BusinessOwnerZipCode | (String) | מיקוד בכתובת המגורים של בעל בית העסק |
| 7 | MotherMaidenName | (String) | שם משפחה של האם לפני הנישואין |
RESPONSE של New company.
|
מספר |
פרמטר | ערכים אפשריים לדוגמא | תיאור |
| 1 | ResponseCode | 0 | קוד תשובה, אם שווה לאפס הפונקציה בוצעה בצורה תקינה. בכל תשובה אחרת, הפעולה לא הייתה תקינה. |
| 2 | Description | "OK" | תיאור התשובה. ''OK'' זה טוב. |
| 3 |
CompanyInternalID |
21348 | מספר חברה שנפתח בקארדקום. |
| 4 |
TerminalNumber |
1000 | מספר מסוף. |
| 5 | APIUserName | "test2025" | שם משתמש API של הבית עסק. |
| 6 | APISecret | "test5000$" | סיסמת API של בית העסק. |
| 7 |
ModulesList מערך של strings. |
"הוראת קבע" דפי נחיתה" פרופיל נמוך" | רשימת המודולים שנפתחו. |
| 8 | UpayAPIKey | (String) |
.UpayAPIKey |
| 9 | ShowErrorToEndUser | boolean - true \ false. |
האם להציג קודי שגיאה ללקוח קצה. |
| 10 | CardComSapakNumber | (String) | מספר ספק קארדקום במקרה ויש. |
| 11 | CompanyNumber | 21351 | מספר פנימי של בית העסק. |
להלן קוד לדוגמא לפונקציה ביחד עם התשובה.
דוגמא לקריאה:
דוגמא לתשובה המתקבלת: