Configurare l'integrazione dei pagamenti

Abilita il tuo sito Power Pages ad accettare pagamenti utilizzando l'area di lavoro Configura dello studio di progettazione. Con questa integrazione senza codice, puoi aggiungere un componente di pagamento al tuo modulo in più passaggi, consentendo al tuo sito Web di integrarsi con un fornitore di servizi di pagamento.

Per accettare pagamenti sul tuo sito Power Pages, devi completare questi passaggi:

Passaggio 1: installare il pacchetto. In questo passaggio, l'amministratore del sito installa il pacchetto composto da tabelle e atri prerequisiti necessari per l'ambiente per abilitare l'esperienza dei pagamenti.

Passaggio 2: configurare i provider In questo passaggio, l'amministratore del sito o il produttore configura le chiavi specifiche di un fornitore di servizi di pagamento.

Passaggio 3: attivare l'esperienza di pagamento nel modulo. In questo passaggio, il produttore include il modulo e abilita i pagamenti digitali nel passaggio richiesto per il modulo con più passaggi.

Importante

• Questa funzionalità funziona solo con il modello di dati avanzato.
• Questa funzionalità richiede il sito Web Power Pages versione build 9.5.10.x perché il controllo dei pagamenti venga visualizzato sul sito.

Prerequisiti

• Crea un account con Stripe come fornitore di servizi di pagamento e ottieni la modalità di prova o le chiavi live dall'app di pagamenti installata dal Marketplace Stripe.
• Crea o identifica una tabella Microsoft Dataverse che vuoi usare in un modulo con più passaggi. Questa tabella deve avere un tipo di campo valuta utilizzato per addebitare l'importo che desideri riscuotere dall'utente del sito. Per altre informazioni, vedi Come creare e modificare tabelle di Dataverse usando l'area di lavoro Dati.
• Configura un modulo con più passaggi usando una tabella Dataverse che ha un passaggio per consentire agli utenti di pagare. Questo passaggio visualizza il controllo dei pagamenti una volta configurato in un passaggio successivo.

Passaggio 1: installare il pacchetto

1. Nello studio di progettazione seleziona Configura.
2. In Integrazioni, seleziona App esterne.
3. Seleziona l'azione Installa per Stripe.
4. Una volta completata l'installazione del pacchetto, riavvia il sito Web da Azioni sito nell'interfaccia di amministrazione.

L'azione di installazione può richiedere alcuni minuti. Una volta completata l'installazione, l'azione diventa Gestisci.

Passaggio 2: configurare il fornitore

Una volta installato il pacchetto, puoi iniziare a configurare Stripe per il sito Power Pages.

Passaggio 2a: Ottieni le tue chiavi Stripe

1. Nello studio di progettazione seleziona Configura.

2. In Integrazioni, seleziona App esterne.

3. Nella tabella Integrazioni, seleziona l'azione Gestisci per Stripe.

4. Vai su Stripe Marketplace e installa l'app Microsoft Power Pages Pagamenti.

5. Dopo aver installato l'app, ottieni le chiavi Pubblicabile e Limitata necessarie per abilitare questa integrazione. Questi valori saranno necessari nei passaggi successivi.

   Nota

   • Per la chiave segreta, ti consigliamo di utilizzare le chiavi API limitate fornite da Stripe per limitare l'accesso e le autorizzazioni per le diverse aree dei dati del tuo account in Stripe.
   • Nella versione 9.6.3.x è stato aggiunto supporto per le chiavi in modalità live oltre alle chiavi in modalità test. Per comprendere i vari tipi di chiavi, fai riferimento alla documentazione di Stripe sulle chiavi API.

Passaggio 2b: Scegli il tipo di archiviazione

È possibile utilizzare Dataverse (supporta solo la modalità di test) o Azure Key Vault (supporta sia la modalità di test che quella live) per archiviare le chiavi API Stripe.

Se scegli Dataverse, continua con passaggio 2D (Aggiungi le tue chiavi alla tua configurazione).

Se utilizzi Azure Key Vault, aggiungi la chiave Limitata di Stripe come segreto in un insieme di credenziali delle chiavi e assegna autorizzazioni al tuo sito seguendo il passaggio 2c (Configurare Azure Key Vault (facoltativo)).

Passaggio 2c: Configura Azure Key Vault (facoltativo)

Se scegli Azure Key Vault come tipo di archiviazione, completa i seguenti passaggi.

1. Nel portale di Azure, ottieni il nome della tua app in Registrazioni app che corrisponde al tuo sito Web Power Pages.

   Il nome dell'app è lo stesso del tuo sito web con il prefisso "Portals-". Se il nome del tuo sito è "Applicazioni Woodgrove Bank", il nome dell'app sul portale Azure è "Portali-Applicazioni Woodgrove Bank". Annotare il nome di registrazione dell'app per utilizzarlo nei passaggi successivi.

   

2. Accedi al portale di Azure e vai a Key Vault.

3. Crea un nuovo insieme di credenziali delle chiavi o usane uno esistente. Durante la creazione di un nuovo archivio di chiavi, è necessario scegliere un modello di autorizzazione. È possibile scegliere tra Azure controllo degli accessi basato sui ruoli o una politica di accesso al Key Vault. Per visualizzare i passaggi appropriati, Seleziona la scheda sottostante in base al modello di autorizzazione scelto.

   Controllo dell'accesso basato sui ruoli di Azure

   1. Vai all'insieme di credenziali delle chiavi nel portale di Azure.
   2. Seleziona Controllo di accesso (IAM) nel riquadro sinistro.
   3. Seleziona + Aggiungi nella parte superiore della pagina, quindi seleziona Aggiorna assegnazione ruolo.
   4. Nella scheda Ruoli funzione lavoro , cerca il nome del ruolo Utente Key Vault Secrets , Seleziona e poi Seleziona Avanti.
   5. Per Assegna accesso a seleziona Utente, gruppo o entità servizio.
   6. Seleziona + Seleziona membri e cerca il nome della registrazione dell'app del tuo sito come descritto all'inizio del passaggio 2c.
   7. Seleziona l'app per il tuo sito e Seleziona Avanti.
   8. Seleziona Rivedi + assegna.

   Politica di accesso al Key Vault

   1. Seleziona Criteri di accesso nel menu del riquadro sinistro.
   2. Seleziona + Crea nella parte superiore della pagina.
   3. In Autorizzazioni segrete, Seleziona Ottieni>Avanti.
   4. Cerca il nome della registrazione dell'app del tuo sito come descritto all'inizio del passaggio 2c.
   5. Seleziona l'app per il sito, quindi seleziona Avanti.
   6. Seleziona Crea.

   Ora il tuo sito ha l'autorizzazione per leggere i segreti da questo archivio di chiavi.

4. Aggiungi la chiave Limitata di Stripe come segreto all'insieme di credenziali delle chiavi. Per informazioni su come creare un segreto in Azure Key Vault, vedi Impostare e recuperare un segreto da Azure Key Vault mediante il portale di Azure.

Passaggio 2d: aggiungere le chiavi alla configurazione

1. Nello studio di progettazione, immetti le impostazioni nel pannello Abilita integrazione.

   Se utilizzi l'opzione di archiviazione di Dataverse, immetti le chiavi Pubblicabile e Segreto.

   Se utilizzi l'opzione di archiviazione Key Vault, immetti la chiave Pubblicabile, il nome di Azure Key Vault e il nome del segreto.

2. Seleziona Salva e chiudi il pannello. Se si verifica un errore durante il salvataggio, fare riferimento al messaggio di errore e risolvere i problemi relativi alla configurazione del key vault.

3. Selezionate Sincronizza.

Passaggio 3: attivare l'esperienza di pagamento nel modulo

Per abilitare i pagamenti, completa i seguenti passaggi:

1. Crea un passaggio del modulo in più passaggi per la tabella Dataverse utilizzata nel processo del modulo con più passaggi in cui desideri accettare i pagamenti.

2. Aggiungi le autorizzazioni per la tabella per le tabelle Dataverse utilizzata nel processo del modulo con più passaggi (hai bisogno delle autorizzazioni di creazione e scrittura) e assegna i ruoli Web appropriati.

3. Selezionate Sincronizza.

4. Nello studio di progettazione, seleziona Pagine e vai alla pagina Web prevista per l'esperienza di pagamento.

5. Aggiungi o modifica il modulo in più passaggi e crea un passaggio chiamato Paga (o simili).

6. Procedi a Impostazioni passaggio.

   

   • Seleziona Integrazioni app.
   • Imposta l'interruttore Abilita pagamenti digitali su Attiva.
   • Nel campo Scegli importo seleziona il campo del tipo di valuta nella tabella utilizzata per addebitare l'importo che desideri riscuotere dall'utente del sito.  

   Nota

   La configurazione dei metodi di pagamento e altre impostazioni possono essere eseguite direttamente in Stripe. Potrebbero richiedere l'accettazione di altri termini e configurazioni.

Il controllo dei pagamenti viene aggiunto automaticamente al passaggio del modulo che mostra un'anteprima dei metodi di pagamento abilitati per accettare pagamenti.

Visualizzare in anteprima la pagina Web e testarla

Nella passaggio Paga, dovresti essere in grado di eseguire un pagamento utilizzando le schede di prova disponibili sul sito Web di Stripe.

Un pagamento andato a buon fine mostra la conferma con l'importo pagato e un ID transazione restituito dal fornitore di servizi di pagamento.

Nota

Devi disabilitare il pulsante Indietro dalle impostazioni del passaggio se non desideri consentire agli utenti di passare al passaggio precedente dalla fase di pagamento.

Se questo passaggio è l'ultimo passaggio del tuo modulo con più passaggi, viene abilitato un pulsante di invio che invia il modulo e completa il processo.

Funzionalità di controllo dei pagamenti in un tenant

Un amministratore può disabilitare i pagamenti in un tenant impostando l'impostazione a livello di tenant disablePaymentIntegrationForPages tramite PowerShell.

Per eseguire i cmdlet PowerShell, devi prima installare i moduli necessari.

Disabilitare i pagamenti

Dopo l'installazione dei moduli, esegui il comando seguente in una finestra PowerShell come amministratore:

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

Gli amministratore con uno dei seguenti ruoli di Azure sono amministratori:

• Amministratore di Dynamics 365
• Amministratore di Power Platform

Quando la funzionalità dei pagamenti è disabilitata in un tenant:

• Per i creatori è disponibile la seguente esperienza nell'area App esterne.

  

• Per i creatori è disponibile la seguente esperienza nella scheda Integrazioni app di una configurazione di modulo con più passaggi.

  

Ogni esperienza include il seguente messaggio:

"Questa applicazione è stata disattivata dalla tua organizzazione. Contatta l'amministratore per abilitarla."

Nota

Quando questa opzione del tenant è impostata su Tutto, impedisce la configurazione della funzionalità di pagamento per siti aggiuntivi. Non influisce in alcun modo sulla configurazione e sulle impostazioni di pagamento dei moduli che potrebbero essere già stati compilati dai creatori nei loro ambienti.

Abilita pagamenti

Per abilitare la funzionalità di pagamento in un tenant, eseguire il seguente comando in una finestra PowerShell come amministratore:

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

Considerazioni

• Valute e importi di pagamento. I valori dell'importo minimo e massimo del pagamento possono variare in base alla valuta. Rivedi la Documentazione Stripe sulle valute supportate per garantire che il modulo e le tabelle siano configurati correttamente per accettare pagamenti in tale intervallo.

• Conformità agli standard PCI DSS (Payment Card Industry Data Security Standard). Questa funzionalità utilizza l'approccio di integrazione dei pagamenti Elementi Web Stripe e i dati della carta non sono archiviati in Power Pages o Dataverse. La conformità PCI è una responsabilità condivisa e si applica anche alle aziende. Vedi la documentazione di Stripe sulla convalida della conformità PCI.

• Tabella dei pagamenti. Per la memorizzazione delle transazioni, è disponibile una nuova tabella dei pagamenti installata con la soluzione. La tabella viene automaticamente correlata alla tabella scelta quando si configurano i passaggi del modulo. È possibile utilizzare la tabella per visualizzare i dettagli delle transazioni e dello stato. Questa tabella è solo un'istantanea delle informazioni fornite che puoi utilizzare per creare altre esperienze per i tuoi utenti aziendali in Power Apps o Power Pages. Per maggiori dettagli e risoluzione dei problemi relativi ai pagamenti, dovresti fare affidamento al fornitore dei servizi di pagamento, come il dashboard di Stripe.

• Webhook. La funzionalità pagamenti configura anche un webhook su Stripe utilizzato per aggiornare in modo asincrono lo stato dei pagamenti che potrebbero richiedere più tempo per il completamento.

  Nota

  Quando un sito Web è in modalità privata, questo webhook potrebbe non essere in grado di comunicare con Power Pages e quindi potresti ricevere e-mail da Stripe. Si tratta di un comportamento intermittente e una volta che il tuo sito Web passa alla modalità pubblica, il webhook dovrebbe essere in grado di comunicare correttamente.