סינון חשבונות שיש לכם גישה אליהם

אפשר להשתמש ב-Merchant Accounts API כדי להציג רשימה מסוננת של החשבונות שיש לך גישה אליהם, כולל חשבונות משנה. אפשר לסנן לפי השמות המוצגים, וגם קשרים עם חשבונות אחרים. לדוגמה, אפשר לסנן חשבונות עם שמות מוצגים שמכילים את מחרוזת "store", שיש להן גם סטטוס קישור PENDING, כדי לראות את כל חנויות שעוד לא אישרו בקשה לקישור חשבון.

כדי להציג את כל חשבונות המשנה, צריך להתקשר accounts.v1beta.accounts.listSubAccounts

כדי להציג רשימה מסוננת של כל החשבונות שיש לכם גישה אליהם, כולל את חשבונות המשנה שלהם ואת כל החשבונות שבהם אתם User, שיחה accounts.v1beta.accounts.list ומציינים את קריטריוני הסינון בשדה filter.

לפרטים על התחביר של השדה filter, אפשר לעיין בתחביר המסנן הפניה.

אלו הם סוגי המסננים שבהם אפשר להשתמש:

מסנני חשבון

אפשר להשתמש בשדות הבאים כדי לסנן ברמת account:

• accountName: סינון לפי accountName של המשאב account.
• relationship(...): סינון לפי סוג הקשר שיש לחשבון עם חשבון אחר. אפשר לכלול כמה מסננים של relationship(...) בבקשה אחת.

מסננים של מערכות יחסים

אפשר להשתמש בפונקציה relationship(...) כדי לסנן לפי קריטריונים:

• providerId: המספר המזהה של ספק השירות. לדוגמה, אם מסנן אמור להחזיר רק חשבונות שיש להם שירות שניתן על ידי account/123, שימוש ב-providerId = 123.
• callerHasAccessToProviderFilter(): מסננים לחשבונות עם הקשר עם ספק שירות שיש לכם גישה אליו.
• externalAccountId: מספר החשבון החיצוני של ספק השירות החשבון שהוא מספק לו שירות.
• accountIdAlias: הכינוי של מזהה החשבון שהוגדר עבור קשר גומלין.
• service(...): השירות שניתן כחלק מהקשרים. אפשר לכלול כמה פונקציות של service(...) בrelationship(...) אחד מותאמת אישית.

מסנני שירות

אפשר להשתמש בפונקציה service(...) כדי לסנן חשבונות נוספים לפי הסטטוס של הקשרים ביניהם וסוגי השירותים של הקשרים האלה מספקים:

• handshakeState: המצב של הסכם השירות בין שני חשבונות. אפשר להשתמש בערכים הבאים:
  • PENDING
  • APPROVED
• type: סוג השירות שניתן על ידי הספק. מקבל/ת את התנאים הבאים ערכים:
  • ACCOUNT_MANAGEMENT הספק מנהל את החשבון.
  • ACCOUNT_AGGREGATION הספק הוא אתר אגרגטור של החשבון.

דוגמאות

הנה כמה דוגמאות למסננים שאפשר לנסות.

סינון חשבונות עם שמות מוצגים שמכילים את המילה 'חנות' וספקים עם מזהה "123":

accountName = "*store*" AND relationship(providerId = 123)

סינון לפי כל חשבונות המשנה בחשבון 123:

relationship(providerId = 123 AND service(type = "ACCOUNT_AGGREGATION"))

סינון חשבונות עם שירותי ניהול חשבון שאושרו:

relationship(service(handshakeState = "APPROVED" AND type = "ACCOUNT_MANAGEMENT"))

סינון חשבונות עם כינוי ומזהה ספציפיים שיש להם גישה לספק. בנוסף, צריכה להיות לכם גישה לספק כדי לשלוח את הבקשה הזו:

relationship(callerHasAccessToProviderFilter() AND externalAccountId = "extAcctId" AND accountIdAlias = "alias")

המאמרים הבאים

• למידע נוסף על סינון חשבונות, אפשר לעיין במאמר סינון תחביר.