Descripción general de los alcances

Puedes definir lo que una aplicación puede hacer en una cuenta. A esto se le llama alcances de la aplicación. Los alcances representan permisos otorgados a una aplicación para acceder a recursos específicos o realizar ciertas acciones en nombre de un usuario. Definen el nivel de acceso que tienen las aplicaciones una vez autenticadas.

Concesiones de alcance de la app (global)

Descripción: Los alcances globales son permisos establecidos a nivel de toda la aplicación por los administradores del sistema a través del CMS. Estos definen los permisos más amplios que una aplicación puede usar. Propósito: Garantiza que una aplicación no pueda solicitar acceso a más recursos de los permitidos como máximo, independientemente de los permisos individuales de los usuarios.

Concesiones de alcance del usuario (individual)

Descripción: Los alcances del usuario son permisos otorgados por usuarios individuales, especificando a qué aspectos de sus datos o funcionalidades puede acceder una aplicación. Propósito: Brinda a los usuarios control sobre sus datos y limita a las aplicaciones a acceder solo a lo necesario y explícitamente permitido por el usuario.

Requisitos para un alcance válido

Esto se verifica durante generateUserAccessToken. Para que el alcance de una aplicación se considere activo y válido: Ambas concesiones deben estar activas: El permiso debe concederse tanto a nivel global (por administradores/sistema) como a nivel individual del usuario. Concesiones no vencidas: Tanto las concesiones globales como las de usuario deben estar vigentes y no vencidas. Una concesión vencida revocará automáticamente el acceso de la aplicación a los recursos especificados.

Alcances de la aplicación

A continuación se muestra una lista de alcances disponibles para cualquier aplicación.

KEY	Uso
LIST_PAYMENT	Permite acceder a los métodos de pago del usuario y al saldo de la cuenta.
LIST_PURCHASES	Permite acceder al historial de compras del usuario.
LIST_OFFERS	Permite acceder al catálogo de ofertas y a los datos de inventario.
MAKE_DEPOSIT	Permite realizar un depósito al saldo del usuario.
PURCHASE_GIFTCARD	Permite comprar una tarjeta de regalo.
REVEAL_GIFTCARD	Permite revelar el código de una tarjeta de regalo para canje.
MANAGE_PAYMENT	Permite realizar cambios en los métodos de pago del usuario.
REVEAL_VIRTUALCARD	Permite revelar los detalles de una tarjeta virtual.
CREATE_VIRTUALCARD	Permite acceder para crear una tarjeta virtual.
EDIT_VIRTUALCARD	Permite editar, bloquear y desbloquear tarjetas virtuales.
PCI_COMPLIANCE	Requerido junto con otros alcances para operaciones que devuelven datos de tarjeta bajo el alcance PCI.

Obtener alcances de la aplicación

Puedes usar la consulta getApplicatonScopes para obtener los alcances actuales de tu aplicación en la cuenta. La consulta responderá con un arreglo de cadenas que indican qué alcance está actualmente concedido.

# Query
query getApplicationScopes {
  getApplicationScopes
}

# Response
{
  "data": {
    "getApplicationScopes": ["LIST_PAYMENT"]
  }
}

Asegúrate de tener los permisos correctos para realizar ciertas mutaciones y consultas con la API de Fluz.

Comienza

Panel de Fluz

Guías rápidas

Alcances de la aplicación

Descripción general de los alcances

Concesiones de alcance de la app (global)

Concesiones de alcance del usuario (individual)

Requisitos para un alcance válido

Alcances de la aplicación

Obtener alcances de la aplicación

​Descripción general de los alcances

​Concesiones de alcance de la app (global)

​Concesiones de alcance del usuario (individual)

​Requisitos para un alcance válido

​Alcances de la aplicación

​Obtener alcances de la aplicación

Descripción general de los alcances

Concesiones de alcance de la app (global)

Concesiones de alcance del usuario (individual)

Requisitos para un alcance válido

Alcances de la aplicación

Obtener alcances de la aplicación