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 elaccountName
del recursoaccount
.relationship(...)
: Filtra según el tipo de relación que la cuenta tiene con otra cuenta. Puedes incluir varios filtrosrelationship(...)
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 poraccount/123
, usaproviderId = 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ónservice(...)
: Es el servicio que se proporciona como parte de la relación. Puedes incluir varias funcionesservice(...)
en una funciónrelationship(...)
.
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.