Impostazione di gateway di pagamento di terze parti

Impostazione iniziale per la configurazione del gateway di pagamento di terze parti

1. Creare un account commerciante di e-commerce nel gateway di pagamento di terze parti che si desidera implementare.
   1. Accedere al provider di gateway di pagamento di terze parti e aggiungere un account commerciante di e-commerce.
   2. Accedere alla sezione Gestione chiavi, sviluppatore o impostazioni avanzate della piattaforma gateway di pagamento scelta e generare una chiave API o una chiave segreta.

      La chiave API avrà l'aspetto seguente: AQEvhmfxJ43HaxxHw0m/n3Q5qf3Ve4pBCIBMV3dVwyD4zesmTx/rk8/RZRz2w0bDdqMQwV1bDb7kfNy1WIxIIkxgBw==-C5bPe6tPCqOM35AEGroDa54J1Bl9AnsQKrDsDofVlrk=-i1ibf$Hu2v>8jR:Y9nU.

   3. Prendere nota del nome utente dell'account commerciante e della chiave API. Sono necessarie per creare le credenziali denominate.
2. Creare le classi Apex gateway di pagamento nell'organizzazione Salesforce.
   1. Ottenere i dettagli della classe adattatore dal provider del gateway di pagamento o da AppExchange.
      Per creare e impostare adattatori gateway di pagamento, vedere Adattatori gateway di pagamento. Per definire le classi Apex, vedere Commerce Payments namespace.
   2. Salvare le classi Apex. Prendere nota del nome dell'adattatore necessario per creare il provider del gateway di pagamento.
3. Creare una credenziale denominata legacy nell'organizzazione Salesforce per specificare i parametri di autenticazione e l'URL dell'endpoint di chiamata Apex.
   1. Specificare un nome intuitivo per l'etichetta e un identificatore univoco per il nome.
   2. Immettere l'URL del gateway di pagamento di terze parti.
   3. Selezionare Entità denominata come tipo di identità e Autenticazione password come protocollo di autenticazione.
   4. Utilizzare il nome utente dell'account commerciante come nome utente. Utilizzare la chiave API come password in base alle esigenze del provider del gateway di pagamento.
   5. Salvare le credenziali denominate necessarie per creare il gateway di pagamento.
4. Registrare il sito gateway di pagamento di terze parti nell'organizzazione Salesforce per assicurarsi che le chiamate Apex dall'organizzazione al sito gateway di pagamento vadano a buon fine.
   1. Immettere un nome e un URL del gateway di pagamento di terze parti.
   2. Contrassegnare il sito come attivo e salvare le modifiche.
5. Aggiungere l'URL gateway di pagamento di terze parti come URL affidabile nell'organizzazione Salesforce.
   1. Immettere un nome API.
   2. Immettere l'URL del gateway di pagamento di terze parti.
   3. Contrassegnare l'URL come attivo e salvare le modifiche.
6. Abilitare e configurare il sito Salesforce per poter inviare e ricevere notifiche di pagamento dal gateway di terze parti.
   1. Immettere un'etichetta, un nome e una pagina iniziale per il sito.
   2. Impostare le impostazioni di accesso pubblico del sito su Accesso guest all'API Pagamenti.
   3. Salvare i dettagli del sito.

Configurazione delle impostazioni di notifica nel gateway di pagamento di terze parti

Il gateway di pagamento utilizza un webhook per inviare notifiche all'adattatore gateway di pagamento. Un webhook è una combinazione dell'endpoint del sito e dell'ID del provider del gateway di pagamento. Creare un webhook specificando un URL nelle impostazioni di trasporto notifiche standard del gateway di pagamento di terze parti.

1. Utilizzare questo URL per l'endpoint del sito, sostituendo MyDomainName con il dominio e l'URL del sito. Ad esempio:
   https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify
2. Individuare l'ID del provider del gateway di pagamento e aggiungere il parametro di query ?provider=ID all'endpoint. Ad esempio, https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify?provider=0cJR00000004CEhMAM
3. Immettere il webhook nelle impostazioni di notifica standard del gateway di pagamento di terze parti.

Configurazione del fornitore del gateway di pagamento e del gateway di pagamento

Aggiungere un provider di gateway di pagamento dopo aver impostato l'account commerciante, le classi di adattatori e il sito Salesforce. Quindi, aggiungere un gateway di pagamento al provider del gateway di pagamento.

1. Da Imposta, nella casella Ricerca veloce, immettere Fatturazione e quindi selezionare Fase 7: Configurazioni pagamento nell'Impostazione guidata.
2. Espandere la fase Configura gateway di pagamento, fare clic su Configura gateway di pagamento e quindi su Configura.
   

   Nota

   Per le organizzazioni Salesforce create nel rilascio Winter '26, il pulsante Configura gateway di pagamento nel passaggio 7: Configurazioni di pagamento dell'impostazione guidata fatturazione, che reindirizza gli utenti alla scheda Configurazione gateway di pagamento, è disponibile per impostazione predefinita. Per le organizzazioni Salesforce create prima del rilascio Winter '26, la scheda Configurazione gateway di pagamento non è disponibile per impostazione predefinita. Per risolvere questo problema, modificare le impostazioni della scheda Configurazione gateway di pagamento su Impostazioni predefinite attivate.

3. Compilare questi campi per creare un provider di gateway di pagamento.
   1. Immettere un nome e un'etichetta univoci per il provider del gateway di pagamento.
   2. Selezionare la classe dell'adattatore Apex dall'elenco a discesa.
   3. Specificare il supporto richiesto per l'impotenza. Per ulteriori dettagli, vedere Linee guida sull'impotenza.
   4. Salvare i dettagli del provider del gateway di pagamento.
4. Compilare questi campi per aggiungere un gateway di pagamento.
   1. Immettere un nome univoco per il gateway di pagamento.
   2. Selezionare un fornitore di gateway di pagamento dall'elenco a discesa.
   3. Selezionare una credenziale denominata dall'elenco a discesa.
   4. Contrassegnare lo stato del gateway di pagamento come Attivo.
   5. Salvare i dettagli del gateway di pagamento.

   Se si dispone già di un provider di gateway di pagamento esistente, selezionare Fase 7: Configurazioni pagamento nell'Impostazione guidata, espandere la fase Configura gateway di pagamento e fare clic su Configura gateway di pagamento. Nella pagina Configurazione gateway di pagamento, fare clic su Gateway di pagamento e quindi su Nuovo. I passaggi di configurazione sono gli stessi.

Aggiunta di più metodi di pagamento

Configurare il supporto per metodi di pagamento come Camera di compensazione automatica (ACH), Area di pagamento unica in euro (SEPA), Servizi di compensazione automatici bancari (BACS) e Sistema di compensazione elettronico in blocco (BECS) sul gateway di pagamento di terze parti. È possibile elaborare i pagamenti, emettere rimborsi e visualizzare questi metodi di pagamento salvati nella scheda Metodi di pagamento salvati del profilo di fatturazione.

• Per aggiungere metodi di pagamento bancari come ACH, SEPA, BACS e BECS, utilizzare l'API tokenizePaymentMethod e impostare la proprietà bankType nell'oggetto bankPaymentMethod sul metodo di pagamento bancario scelto.
• Per aggiungere metodi di pagamento con carta, ad esempio carta di credito o di debito, utilizzare l'API tokenizePaymentMethod e impostare la proprietà cardCategory nell'oggetto cardPaymentMethod.