Externe betalingsgateways instellen

Initiële set-up voor het configureren van externe betalingsgateway

1. Maak een e-commercehandelaarsaccount in de externe betalingsgateway die u wilt implementeren.
   1. Log in bij uw externe betalingsgatewayprovider en voeg een e-commercehandelaarsaccount toe.
   2. Navigeer naar de sectie voor sleutelbeheer, ontwikkelaar of geavanceerde instellingen van het gekozen betalingsgatewayplatform en genereer een API-sleutel of geheime sleutel.

      Uw API-sleutel ziet er dan als volgt uit: AQEvhmfxJ43HaxxHw0m/n3Q5qf3Ve4pBCIBMV3dVwyD4zesmTx/rk8/RZRz2w0bDdqMQwV1bDb7kfNy1WIxIIkxgBw==-C5bPe6tPCqOM35AEGroDa54J1Bl9AnsQKrDsDofVlrk=-i1ibf$Hu2v>8jR:Y9nU.

   3. Noteer de gebruikersnaam en API-sleutel van de handelaarsaccount. U hebt ze nodig om de benoemde inloggegevens te maken.
2. Maak uw betalingsgateway Apex klassen in uw Salesforce-organisatie.
   1. Haal de details van de adapterklasse op bij uw betalingsgatewayprovider of AppExchange.
      Zie Betalingsgatewayadapters voor het samenstellen en instellen van betalingsgatewayadapters. Zie Commerce Payments-naamruimte om uw Apex klassen te definiëren.
   2. Sla uw Apex klassen op. Noteer de adapternaam, aangezien u deze nodig hebt om uw betalingsgatewayprovider te maken.
3. Maak een verouderd benoemd gegeven in uw Salesforce-organisatie om authenticatieparameters en de URL van uw Apex aanroepeindpunt op te geven.
   1. Geef een gebruikersvriendelijke naam voor het label en een unieke identifier voor de naam op.
   2. Geef de URL op van uw externe betalingsgateway.
   3. Selecteer Met naam genoemde hoofdpersoon als identiteitstype en Wachtwoordauthenticatie als authenticatieprotocol.
   4. Gebruik de gebruikersnaam van uw handelaarsaccount als gebruikersnaam. Gebruik de API-sleutel als wachtwoord zoals vereist door uw betalingsgatewayprovider.
   5. Sla de benoemde gegevens op zoals u ze nodig hebt om uw betalingsgateway te maken.
4. Registreer uw externe betalingsgateway-site in uw Salesforce-organisatie om ervoor te zorgen dat Apex aanroepen vanuit de organisatie naar de betalingsgateway-site succesvol zijn.
   1. Geef een naam en URL op van uw externe betalingsgateway.
   2. Markeer de site als actief en sla uw wijzigingen op.
5. Voeg uw externe betalingsgateway-URL toe als een vertrouwde URL in uw Salesforce-organisatie.
   1. Voer een API-naam in.
   2. Geef de URL op van uw externe betalingsgateway.
   3. Markeer de URL als actief en sla uw wijzigingen op.
6. Schakel uw Salesforce-site in en stel deze in, zodat u betalingskennisgevingen kunt verzenden en ontvangen vanuit uw externe gateway.
   1. Geef een label, naam en hoofdpagina voor uw site op.
   2. Stel de instellingen voor openbare toegang van de site in op Gasttoegang tot de Payments API.
   3. Sla de details van uw site op.

Kennisgevingsinstellingen configureren voor uw externe betalingsgateway

De betalingsgateway gebruikt een webhook om kennisgevingen te verzenden naar uw betalingsgatewayadapter. Een webhook is een combinatie van uw site-eindpunt en de ID van de betalingsgatewayprovider. Maak een webhook door een URL op te geven in de standaardinstellingen voor kennisgevingstransport van uw externe betalingsgateway.

1. Gebruik deze URL voor het eindpunt van uw site en vervang MyDomainName door het domein en de URL van uw site. Bijvoorbeeld:
   https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify
2. Zoek de ID van uw betalingsgatewayprovider en voeg de parameter ?provider=ID toe aan het eindpunt. Bijvoorbeeld https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify?provider=0cJR00000004CEhMAM
3. Geef de webhook op in de standaardinstellingen voor kennisgevingen van uw externe betalingsgateway.

Aanbieder van betalingsgateway en betalingsgateway configureren

Voeg een betalingsgatewayprovider toe nadat u uw handelaarsaccount, uw adapterklassen en uw Salesforce-site hebt ingesteld. Voeg vervolgens een betalingsgateway toe aan de betalingsgatewayprovider.

1. Geef vanuit Set-up Facturering op in het vak Snel zoeken en selecteer vervolgens Stap 7: Betalingsconfiguraties in de Begeleide set-up.
2. Vouw de stap Externe betalingsgateways configureren uit, klik op Betalingsgateways configureren en klik vervolgens op Configureren.
   

   Opmerking

   Voor Salesforce-organisaties die zijn gemaakt in Winter '26, is de knop Betalingsgateways configureren in stap 7: Betalingsconfiguraties van de Begeleide set-up voor facturering, die gebruikers omleidt naar het tabblad Configuratie van betalingsgateway, standaard beschikbaar. Voor Salesforce-organisaties die zijn gemaakt vóór Winter '26, is het tabblad Configuratie van betalingsgateway standaard niet beschikbaar. Als u dit probleem wilt oplossen, wijzigt u de instellingen van het tabblad Configuratie van betalingsgateway in Standaard aan.

3. Vul deze velden in om een betalingsgatewayprovider te maken.
   1. Geef een unieke naam en een uniek label op voor uw betalingsgatewayprovider.
   2. Selecteer de Apex adapterklasse in de vervolgkeuzelijst.
   3. Geef uw vereiste ondersteuning voor idempotentie op. Zie Richtlijnen voor impotentie voor meer informatie.
   4. Sla de details van de betalingsgatewayleverancier op.
4. Vul deze velden in om een betalingsgateway toe te voegen.
   1. Geef een unieke naam op voor uw betalingsgateway.
   2. Selecteer een betalingsgatewayprovider in de vervolgkeuzelijst.
   3. Selecteer een benoemd gegeven in de vervolgkeuzelijst.
   4. Markeer de status van uw betalingsgateway als Actief.
   5. Sla de details van de betalingsgateway op.

   Als u al een bestaande betalingsgatewayleverancier hebt, selecteert u Stap 7: Betalingsconfiguraties in de Begeleide set-up, vouwt u de stap Externe betalingsgateways configureren uit en klikt u op Betalingsgateways configureren. Klik op de pagina Configuratie van betalingsgateway op Betaalgateways en vervolgens op Nieuw. De configuratiestappen zijn dezelfde.

Meerdere betalingswijzen toevoegen

Configureer ondersteuning voor betalingswijzen zoals Automated Clearing House (ACH), Single euro Payments Area (SEPA), Bankers' Automated Clearing Services (BACS) en Bulk Electronic Clearing System (BECS) op uw externe betalingsgateway. U kunt betalingen verwerken, restituties uitgeven en deze opgeslagen betalingswijzen weergeven op het tabblad Opgeslagen betalingswijzen van uw factureringsprofiel.

• Als u bankbetalingsmethoden zoals ACH, SEPA, BACS en BECS wilt toevoegen, gebruikt u de API tokenizePaymentMethod en stelt u de eigenschap bankType in het bankPaymentMethod in op de gekozen bankbetalingswijze.
• Gebruik voor het toevoegen van betalingswijzen met kaart, zoals creditcard of betaalpas, de API tokenizePaymentMethod en stel de eigenschap cardCategory in het object cardPaymentMethod in.