Filtra las cuentas a las que puedes acceder

Puedes usar la API de cuentas de Merchant para ver una lista filtrada de las cuentas a las que tienes acceso, incluidas las cuentas secundarias. Puedes filtrar por nombres visibles y relaciones con otras cuentas. Por ejemplo, puedes filtrar por cuentas con nombres visibles que contengan la cadena "store", que también tengan un estado de vinculación PENDING, para ver todas tus tiendas que aún no aceptaron una solicitud de vinculación de cuenta.

Para ver todas tus cuentas secundarias, llama a accounts.v1beta.accounts.listSubAccounts.

Para ver una lista filtrada de todas las cuentas a las que tienes acceso, incluidas las cuentas secundarias y cualquier cuenta que te tenga como User, llama a accounts.v1beta.accounts.list y especifica tus criterios de filtro en el campo filter.

Para obtener detalles sobre la sintaxis del campo filter, consulta la referencia de sintaxis de filtros.

A continuación, se incluyen los tipos de filtros que puede utilizar:

Filtros de la cuenta

Puedes usar los siguientes campos para filtrar en el nivel de account:

• accountName: Filtra por el accountName del recurso account.
• relationship(...): Filtra según el tipo de relación que la cuenta tiene con otra cuenta. Puedes incluir varios filtros relationship(...) en una solicitud.

Filtros de relaciones

Puedes usar la función relationship(...) para filtrar según los siguientes criterios:

• providerId: Es el ID del comerciante del proveedor de servicios. Por ejemplo, si el filtro debe mostrar solo las cuentas que tienen un servicio proporcionado por account/123, usa providerId = 123.
• callerHasAccessToProviderFilter(): Filtra las cuentas que están relacionadas con un proveedor de servicios al que tienes acceso.
• externalAccountId: Es el ID de cuenta externo del proveedor de servicios de la cuenta a la que proporciona un servicio.
• accountIdAlias:: El alias del ID de la cuenta que se configuró para la relación
• service(...): Es el servicio que se proporciona como parte de la relación. Puedes incluir varias funciones service(...) en una función relationship(...).

Filtros de servicios

Puedes usar la función service(...) para filtrar aún más las cuentas según el estado de sus relaciones y los tipos de servicios que proporcionan:

• handshakeState: Es el estado de un acuerdo de servicio entre dos cuentas. Acepta los siguientes valores:
  • PENDING
  • APPROVED
• type:: Es el tipo de servicio proporcionado por el proveedor. Acepta los siguientes valores:
  • ACCOUNT_MANAGEMENT El proveedor administra la cuenta.
  • ACCOUNT_AGGREGATION El proveedor es un agregador de la cuenta.

Ejemplos

Estos son algunos ejemplos de los filtros que puedes probar.

Filtra las cuentas con nombres visibles que contengan “tienda” y los proveedores con el ID “123”:

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

Filtrar todas las cuentas secundarias de la cuenta "123":

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

Filtre las cuentas con servicios de administración de cuentas aprobados:

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

Filtra las cuentas con un alias y un ID específicos que tengan acceso a un proveedor. También debes tener acceso al proveedor de esta solicitud:

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

Próximos pasos

• Para obtener más información sobre cómo filtrar cuentas, consulta Sintaxis de filtros.