Filtra gli account a cui puoi accedere

Puoi utilizzare l'API Merchant Accounts per visualizzare un elenco filtrato degli account a cui hai accesso, inclusi i subaccount. Puoi filtrare per nomi visualizzati e relazioni con altri account. Ad esempio, potresti filtrare in base agli account con nomi visualizzati che contengono stringa "store", che ha anche uno stato di collegamento PENDING, per vedere tutti i tuoi negozi che non hanno ancora accettato una richiesta di collegamento dell'account.

Per visualizzare tutti i tuoi subaccount, chiama accounts.v1beta.accounts.listSubAccounts

Per visualizzare un elenco filtrato di tutti gli account a cui hai accesso, inclusi i subaccount e gli account che ti hanno associato User, chiama accounts.v1beta.accounts.list e specificare i criteri di filtro nel campo filter.

Per informazioni dettagliate sulla sintassi del campo filter, consulta la sintassi del filtro riferimento.

Ecco i tipi di filtri che puoi utilizzare:

Filtri account

Puoi utilizzare i seguenti campi per filtrare a livello di account:

• accountName: applica un filtro per accountName della risorsa account.
• relationship(...): filtri in base al tipo di relazione dell'account con un altro account. Puoi includere più filtri relationship(...) in un'unica richiesta.

Filtri per le relazioni

Puoi utilizzare la funzione relationship(...) per filtrare in base a quanto segue di classificazione:

• providerId: l'ID commerciante del fornitore di servizi. Ad esempio, se deve restituire solo gli account che hanno un servizio fornito da account/123, usa providerId = 123.
• callerHasAccessToProviderFilter(): filtri per gli account con un rapporto con un fornitore di servizi a cui hai accesso.
• externalAccountId: l'ID dell'account esterno del fornitore di servizi per a cui fornisce un servizio.
• accountIdAlias: L'alias dell'ID account configurato per relazione tra utenti.
• service(...): il servizio fornito nell'ambito della relazione. Puoi includere più funzioni service(...) in una sola relationship(...) personalizzata.

Filtri del servizio

Puoi utilizzare la funzione service(...) per filtrare ulteriormente gli account in base ai lo stato delle loro relazioni e i tipi di servizi che tali relazioni fornire:

• handshakeState: lo stato di un contratto di servizio tra due account. Accetta i seguenti valori:
  • PENDING
  • APPROVED
• type: Il tipo di servizio fornito dal fornitore. Accetta quanto segue valori:
  • ACCOUNT_MANAGEMENT Il fornitore gestisce l'account.
  • ACCOUNT_AGGREGATION Il fornitore è un aggregatore dell'account.

Esempi

Ecco alcuni esempi di filtri che puoi provare a utilizzare.

Filtra in base agli account con nomi visualizzati contenenti "negozio" e i fornitori con ID "123":

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

Filtra in base a tutti i subaccount dell'account "123":

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

Filtra in base agli account con servizi di gestione degli account approvati:

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

Filtra in base agli account con un alias e un ID specifici, che hanno accesso a un provider. Devi anche avere accesso al provider per questa richiesta:

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

Passaggi successivi

• Per ulteriori informazioni su come filtrare gli account, consulta la sezione Filtro a riga di comando.