Filtra las cuentas a las que puedes acceder

Puedes usar la API de Merchant Accounts 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, podría filtrar las cuentas con nombres visibles que contengan la la cadena "store", que también tienen un estado de vínculo PENDING, para ver todos tus tiendas que aún no aceptaron una solicitud de vinculación de cuenta.

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

Para ver una lista filtrada de todas las cuentas a las que tienes acceso, incluida subcuentas y cuentas en las que apareces User, llamar 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 sintaxis de filtros. referencia.

Estos son los tipos de filtros que puedes usar:

Filtros de la cuenta

Puedes usar los siguientes campos para filtrar a nivel de account:

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

Filtros de relaciones

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

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

Filtros de servicio

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 esas relaciones proporcionar:

• handshakeState: Es el estado de un acuerdo de servicio entre dos cuentas. Acepta los siguientes valores:
  • PENDING
  • APPROVED
• type:: Es el tipo de servicio que brinda el proveedor. Se acepta lo siguiente: 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.

Filtre las cuentas con nombres visibles que contienen "tienda" y proveedores con el ID “123”:

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

Filtro para 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 ID y alias específicos que tienen acceso a un proveedor. También debes tener acceso al proveedor para esta solicitud:

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

¿Qué sigue?

• Para obtener más información sobre cómo filtrar cuentas, consulta Filtrar sintaxis.