Compartir a través de

Configurar la integración de pagos

Habilite su sitio Power Pages para aceptar pagos utilizando el espacio de trabajo Configurar del estudio de diseño. Con esta integración sin código, puede agregar un componente de pago a su formulario multipaso, habilitando su sitio web para integrarse con un proveedor de pagos.

Una captura de pantalla de la integración de pagos dentro de un sitio de Power Pages.

Para aceptar pagos en su sitio de Power Pages, debe completar estos pasos:

Paso 1: Instalación del paquete. En este paso, el administrador del sitio instala el paquete que consta de tablas requeridas y otros requisitos previos para que el entorno habilite la experiencia de pagos.

Paso 2: Configuración del proveedor. En este paso, el administrador del sitio o el creador configura las claves específicas de un proveedor de pagos.

Paso 3: Habilitación de la experiencia de pagos en su formulario. En este paso, el creador incluye el formulario y habilita los pagos digitales en el paso requerido para el formulario de varios pasos.

Importante

Requisitos previos

  • Regístrese para obtener una cuenta con Stripe como su proveedor de pagos y obtenga el modo de prueba o las claves activas de la aplicación de pagos instalada en Stripe Marketplace.
  • Cree o identifique una tabla de Microsoft Dataverse que desee usar en un formulario de varios pasos. Esta tabla debe tener un tipo de campo de moneda que se usa para cargar el importe que desea cobrar al usuario del sitio. Para obtener más información, consulte Cómo crear y modificar tablas de Dataverse con el espacio de trabajo de datos.
  • Configurar un formulario de varios pasos con una tabla de Dataverse con un paso para permitir a los usuarios pagar. Este paso muestra el control de pagos una vez configurado en un paso posterior.

Paso 1: Instalación del paquete

  1. En el estudio de diseño, seleccione Configurar.
  2. En Integraciones, seleccione Aplicaciones externas.
  3. Seleccione la acción Instalar para Stripe.
  4. Una vez que se complete la instalación del paquete, reinicie el sitio web desde Acciones del sitio en el centro de administración.

La acción de instalación puede tardar unos minutos en completarse. La acción cambia a gestionar una vez completada la instalación.

Paso 2: Configuración del proveedor.

Una vez instalado el paquete, puede comenzar a configurar Stripe para su sitio de Power Pages.

Paso 2a: Obtén tus claves de Stripe

  1. En el estudio de diseño, elija Configurar.

  2. En Integraciones, seleccione Aplicaciones externas.

  3. En la tabla Integraciones, seleccione la acción Gestionar para Stripe.

  4. Acceda a Stripe Marketplace e instale la app de Pagos de Microsoft Power Pages.

  5. Una vez instalada la aplicación, obtenga las claves publicables y restringidas necesarias para habilitar esta integración. Estos valores son necesarios en pasos posteriores.

    Nota

    • Para la clave secreta, recomendamos utilizar las claves de API restringidas que Stripe proporciona para limitar el acceso y los permisos para diferentes áreas de los datos de su cuenta en Stripe.
    • En la versión 9.6.3.x. se agregó compatibilidad con las claves del modo activo además de las claves del modo de prueba. Para comprender los distintos tipos de claves, consulte la documentación de Stripe sobre claves de API.

Paso 2b: Elige tu tipo de almacenamiento

Puede utilizar Dataverse (solo admite el modo de prueba) o Azure Key Vault (admite el modo de prueba y el modo activo) para almacenar las claves API de Stripe.

Captura de pantalla del panel Habilitar integración dentro del espacio de trabajo Configurar del estudio de diseño de Power Pages.

Si elige Dataverse, continúe con el Paso 2D (Agregar las claves a la configuración).

Si usa Azure Key Vault, agregue la clave restringida de Stripe como secreto en un almacén de claves y asigne permisos a su sitio siguiendo el paso 2c (Configurar Azure Key Vault (opcional)).

Paso 2c: Configurar Azure Key Vault (opcional)

Si elige Azure Key Vault como tipo de almacenamiento, complete los siguientes pasos.

  1. Dentro del portal de Azure, obtenga el nombre de su aplicación en Registros de aplicaciones que corresponda a su sitio web Power Pages.

    El nombre de la aplicación es el mismo que el nombre de su sitio web con el prefijo "Portals-". Si el nombre de su sitio es "Aplicaciones bancarias Woodgrove", el nombre de la aplicación en Azure Portal será "Portals-Aplicaciones bancarias Woodgrove". Anote este nombre de registro de aplicación para usarlo en los siguientes pasos.

    Captura de pantalla del registro de la aplicación en Azure para un sitio Power Pages.

  2. Inicie sesión en el portal Azure y acceda a los Key Vaults

  3. Cree un nuevo almacén de claves o use un existente. Al crear un nuevo almacén de claves, debe elegir un modelo de permiso. Puede elegir entre Control de acceso basado en roles de Azure o una Directiva de acceso de Key Vault. Para ver los pasos adecuados, seleccione la siguiente pestaña según el modelo de permisos que elija.

    1. Vaya a su almacén de claves en el portal de Azure.
    2. Seleccione Control de acceso (IAM) en el menú de la izquierda.
    3. En la parte superior de la página, seleccione +Agregar y, a continuación, Actualizar asignación de rol.
    4. En la pestaña Roles de función de trabajo, busque el nombre del rol de usuario de secretos de Key Vault, selecciónelo y, a continuación, seleccione Siguiente.
    5. En Asignar acceso a, seleccione Usuario, grupo o entidad de servicio.
    6. Elija + Seleccionar miembros y busque el nombre de registro de la aplicación de su sitio como se describió al comienzo del paso 2c.
    7. Seleccione la aplicación para su sitio y, a continuación, Siguiente.
    8. Seleccione Revisar + asignar.

    Su sitio ahora tiene permisos para leer secretos de este almacén de claves.

  4. Añade tu clave restringida de Stripe como secreto al almacén de claves. Para aprender a crear un secreto en Azure Key Vault, vaya a Establecer y recuperar un secreto desde Azure Key Vault usando el portal de Azure.

Paso 2d: Añade las claves a su configuración

  1. En el estudio de diseño, introduzca la configuración en el panel Habilitar integración.

    Si está utilizando la opción de almacenamiento de Dataverse, introduzca las claves publicables y secretas.

    Si usa la opción de almacenamiento de Key Vault, escriba la clave publicable, nombre de almacén de Azure Key y nombre del secreto.

  2. Seleccione Guardar y cierre el panel. Si encuentra un error al guardar, consulte el mensaje de error y resuelva los problemas relacionados con la configuración de Key Vault.

  3. Haga clic en Sincronizar.

Paso 3: Habilitación de la experiencia de pagos en su formulario

Para habilitar los pagos, complete los siguientes pasos:

  1. Cree un paso de formulario de varios pasos para la tabla de Dataverse utilizada en su proceso de formulario de varios pasos donde desea aceptar los pagos.

  2. Agregue permisos de tabla para las tablas de Dataverse usadas en el proceso de formulario de varios pasos (necesita al menos permisos Crear y Escribir) y asigne los roles web apropiados.

  3. Haga clic en Sincronizar.

  4. En el estudio de diseño, seleccione Páginas y navegue a la página web donde está prevista la experiencia de pago.

  5. Agregue o edite el formulario multipaso y cree un paso llamado Pagar (o similar).

  6. Continúe con Configuración de pasos.

    Captura de pantalla de las opciones de configuración del paso en el espacio de trabajo Páginas del estudio de diseño de Power Pages.

    • Seleccione Integraciones de aplicaciones.
    • Cambie Habilitar pagos digitales a activado.
    • En Elegir el campo de importe, seleccione el campo de tipo de moneda en la tabla utilizada para cobrar el importe que desea recaudar del usuario del sitio.  

    Nota

    La configuración de los métodos de pago y otras opciones pueden realizarse directamente en Stripe. Es posible que exijan la aceptación de otros términos y configuraciones.

El control de pagos se agrega automáticamente al paso de formulario que muestra una vista previa de los métodos de pago habilitados para aceptar pagos.

Obtener una vista preliminar y probar la página web

En el paso Pagar, debería poder realizar un pago mediante tarjetas de prueba disponibles en el sitio web de Stripe.

Un pago efectuado correctamente muestra la confirmación con el importe pagado y un identificador de transacción devuelto por el proveedor del pago.

Nota

Debería deshabilitar el botón de retroceso de la configuración del paso si no quiere permitir a los usuarios ir al paso anterior desde el paso de pago.

Si este paso es el último de su formulario de varios pasos, se habilita un botón Enviar que envía el formulario y completa su proceso.

Función de control de pagos en un inquilino

Un administrador puede deshabilitar los pagos en un inquilino estableciendo la configuración de nivel de inquilino disablePaymentIntegrationForPages a través de PowerShell.

Para ejecutar los cmdlets de PowerShell, debe instalar antes los componentes necesarios.

Desactivar pagos

Después de instalar los módulos, ejecute el comando siguiente en una ventana de PowerShell como administrador.

$requestBody = @{
     powerPlatform = @{
         powerPages = @{
             disablePaymentIntegrationForPages = "All"
         }
     }
 }
 Set-TenantSettings -RequestBody $requestBody

Los administradores son los usuarios que tienen uno de los roles de Azure siguientes:

Cuando la característica de pagos está deshabilitada en un inquilino:

  • Los creadores tienen la siguiente experiencia en el área de Aplicaciones externas .

    Captura de pantalla del panel Activar integración con la integración de pagos de Stripe que se muestra bloqueada.

  • Los creadores tienen la siguiente experiencia en la pestaña Integraciones de aplicaciones de una configuración de formulario de varios pasos.

    Captura de pantalla de la pestaña Integraciones de aplicaciones de un formulario de varios pasos.

Cada experiencia incluye el siguiente mensaje:

"Esta aplicación ha sido deshabilitada por su organización. Póngase en contacto con el administrador para habilitarla."

Nota

Una vez que esta configuración del inquilino se establece en All, impide la configuración de la capacidad de pagos en el futuro para sitios adicionales. No afecta a ninguna configuración ni a la configuración de pagos en formularios que los creadores ya hayan completado en sus entornos.

Habilitar pagos

Para habilitar la función de pagos en un inquilino, ejecute el comando siguiente en una ventana de PowerShell como administrador:

$requestBody = @{
     powerPlatform = @{
         powerPages = @{
             disablePaymentIntegrationForPages = "None"
         }
     }
 }
 Set-TenantSettings -RequestBody $requestBody

Consideraciones

  • Monedas e importes de pago. Los valores del monto de pago mínimo y máximo pueden variar según la moneda. Consulte la documentación de Stripe sobre las divisas admitidas para asegurarse de que su formulario y sus tablas están configurados correctamente para aceptar pagos en ese rango.

  • Estándar de seguridad de datos (PCI DSS) de la Industria de Tarjeta de Pago. Esta función utiliza el enfoque de integración de pagos de Stripe Web Elements y los datos de la tarjeta no se almacenan en Power Pages o Dataverse. El cumplimiento de PCI es una responsabilidad compartida y se aplica también a las empresas. Consulte la documentación de Stripe sobre la validación de su cumplimiento de PCI.

  • Tabla de pagos. Para almacenar transacciones, hay una nueva tabla de pagos instalada con la solución. La tabla se relaciona automáticamente con la tabla que elija al configurar los pasos del formulario. Puede usar la tabla para ver los detalles de las transacciones y el estado. Esta tabla es solo una instantánea de la información que se proporciona y que puede usar para crear otras experiencias para los usuarios de su empresa en Power Apps o Power Pages. Para obtener más detalles y solucionar problemas relacionados con los pagos, debe confiar en el proveedor de pagos, como el panel de Stripe.

  • Webhook. La característica de pagos también configura un webhook en Stripe que se utiliza para actualizar de forma asincrónica el estado de los pagos que pueden tardar más en completarse.

    Nota

    Cuando un sitio web está en modo privado, es posible que este webhook no pueda comunicarse con Power Pages y, por lo tanto, es posible que reciba correos electrónicos de Stripe. Este es un comportamiento intermitente y una vez que su sitio web cambia al modo público, el webhook debería poder comunicarse correctamente.