ה API הבא מאפשר משיכת מידע על כרטיסי אשראי שמורים ללקוח. שמירת הכרטיסים אפשרית למי שמפעיל את מודול שמירת כרטיסי אשראי (מערכת->מנהלה->מודולים נוספים).
מכיוון שאנחנו לא שומרים את מספרי האשראי אצלנו אלא אצל ספק צד ג (על פי חוק) המידע החוזר יכיל רק מידע כללי על כרטיס האשראי ואת 4 הספרות האחרונות שלו. הפניה צריכה להיות (תמיד) מוצפנת דרך https וניתן לפנות ב POST או ב GET. בפועל, מה שנשמר על השרתים שלנו זה token שהוא למעשה הצפנה של מספר האשראי שנשמר אצל ספק חיצוני שעומד בתקן PCI LEVEL 1.
הכתובת אליה צריך להפנות את קריאות הAPI היא:
https://api.icount.co.il/api/v1.php
התגובה תתקבל בפורמט json בלבד.
שם השדה | סוג | תיאור | ערכים אפשריים | ברירת מחדל | חובה |
---|---|---|---|---|---|
פרמטרים | |||||
compID | varchar | מזהה החברה שלך | כן | ||
user | varchar | שם משתמש | כן | ||
pass | varchar | סיסמה | כן | ||
action | varchar | סוג הפעולה. במקרה הזה זה תמיד list_cc | כן | ||
client_id | int | מספר לקוח כפי שמופיע במערכת iCount | ספרות בלבד | ||
vat_id | int | מספר חפ/עמ/תז כפי ששמור בכרטיס הלקוח | ספרות בלבד |
התשובה החוזרת תיראה ככה:
( 'status' => 'ok', 'reason' => array ( 0 => array ( 'cc_type' => 'visa', 'validity' => '0415', 'cc_cardholder_id' => '123456789', 'cc_cardholder_name' => 'ישראל ישראלי', 'last_four' => '1234', ), 1 => array ( 'cc_type' => 'isracard', 'validity' => '0415', 'cc_cardholder_id' => '123456789', 'cc_cardholder_name' => 'ישראל ישראלי', 'last_four' => '1003', ), ), )