Filtruj konta, do których masz dostęp

Filtrowaną listę kont można wyświetlić za pomocą interfejsu Merchant Accounts API do których masz dostęp, m.in. na subkontach. Możesz filtrować według wyświetlanych nazw, relacji z innymi kontami. Możesz np. odfiltrować konta o wyświetlanych nazwach zawierających "store", które mają również stan linku PENDING, aby wyświetlić wszystkie sklepy, które nie zaakceptowały jeszcze prośby o połączenie kont.

Aby wyświetlić wszystkie subkonta, wywołaj accounts.v1beta.accounts.listSubAccounts

Aby wyświetlić przefiltrowaną listę wszystkich kont, do których masz dostęp, w tym subkont oraz wszystkich kont, na których jesteś User, zadzwoń accounts.v1beta.accounts.list i w polu filter podaj kryteria filtrowania.

Szczegółowe informacje o składni pola filter znajdziesz w sekcji Składnia filtra odwołania.

Możesz użyć następujących filtrów:

Filtry konta

Za pomocą tych pól możesz filtrować na poziomie account:

• accountName: filtruje według elementu accountName zasobu account.
• relationship(...): filtrowanie według rodzaju relacji na koncie. z innym kontem. Możesz uwzględnić kilka filtrów relationship(...) w jednym żądaniu.

Filtry relacji

Za pomocą funkcji relationship(...) możesz filtrować na podstawie tych danych kryteria:

• providerId: identyfikator sprzedawcy świadczącego usługi. Na przykład, jeśli plik powinien zwracać tylko te konta, które mają usługę świadczoną przez account/123, użyj formy płatności providerId = 123.
• callerHasAccessToProviderFilter(): filtry dotyczące kont z z dostawcą usług, do którego masz dostęp.
• externalAccountId: identyfikator zewnętrznego konta dostawcy usług dla konto, na którym świadczy usługę.
• accountIdAlias: Alias identyfikatora konta skonfigurowany dla relacji.
• service(...): usługa świadczona w ramach relacji. W jednym elemencie relationship(...) możesz uwzględnić wiele funkcji service(...) .

Filtry usługi

Możesz użyć funkcji service(...), aby dalej filtrować konta na podstawie stanu relacji i rodzajów usług; podaj:

• handshakeState: stan umowy o świadczenie usług między 2 kontami. Akceptuje te wartości:
  • PENDING
  • APPROVED
• type: Rodzaj usługi świadczonej przez dostawcę. Akceptuje te wartości:
  • ACCOUNT_MANAGEMENT Dostawca zarządza kontem.
  • ACCOUNT_AGGREGATION Dostawca to pośrednik w zakresie konta.

Przykłady

Oto kilka przykładów filtrów, które możesz wypróbować.

Zastosuj filtr, aby wyświetlić konta, których wyświetlane nazwy zawierają słowo „sklep” i usługodawców, którzy mają Identyfikator „123”:

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

Filtruj wszystkie subkonta konta „123”:

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

Użyj filtra, aby wyświetlić konta z zatwierdzonymi usługami zarządzania kontem:

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

Odfiltruj konta z określonym aliasem i identyfikatorem, które mają dostęp do dostawcy. W przypadku tej prośby musisz też mieć dostęp do dostawcy:

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

Co dalej?

• Więcej informacji na temat filtrowania kont znajdziesz w sekcji Filtrowanie .