De Bluesnap Shopware 6 plugin is een betrouwbare betaaloplossing die de Bluesnap-gateway koppelt aan uw Shopware-webshop. De plugin ondersteunt verschillende betaalmethoden, zoals creditcards, Apple Pay, Google Pay, Hosted Checkout en Pay by Link. Handelaars kunnen volledige of gedeeltelijke terugbetalingen beheren, 3D Secure voor extra beveiliging activeren en klanten de mogelijkheid bieden om hun kaartgegevens op te slaan, bij te werken of te verwijderen. Met een duidelijk installatieproces en veilige transacties helpt de plugin bedrijven om een soepele en flexibele betaalervaring aan te bieden.
Belangrijkste functies
Aan de slag
Installatie & activering
1.Downloaden
1. Plugininstellingen openen
2. Algemene instellingen
Configureer de API-sleutels en betaalinstellingen voordat u de plugin gebruikt:
1. Creditcardbetaling (Credit Card Capture)
Met deze functie kunnen klanten transacties met hun creditcard afronden via de PCI-conforme betaalgateway van Bluesnap.
Werking:
Klanten voeren hun creditcardgegevens in een beveiligd formulier in.
De betaling wordt verwerkt via de Bluesnap-gateway.
Stappen:
1.Kies “Bluesnap creditcard” als betaalmethode.
2.Voer de creditcardgegevens van de klant in het Bluesnap-formulier in.
3.Verzend de betaling.
2. Gehoste checkout (Hosted Checkout)
De gehoste checkout van Bluesnap biedt een beveiligde, door Bluesnap gehoste checkoutpagina en neemt de directe verwerking van gevoelige betaalgegevens uit handen van handelaars.
Werking:
Klanten worden doorgestuurd naar een beveiligde, gehoste checkoutpagina.
Betalingen worden veilig verwerkt via Bluesnap.
Stappen:
1.Kies “Bluesnap Hosted Checkout” als betaalmethode.
2.De klant wordt doorgestuurd naar de gehoste checkoutpagina.
3.De klant rondt de transactie af op de gehoste pagina.
3. Apple Pay-integratie
Bluesnap ondersteunt Apple Pay en stelt klanten in staat om met hun Apple-apparaten met een eenvoudige tik te betalen.
Werking:
Klanten bevestigen de betaling via hun Apple-apparaat met Face ID, Touch ID of Apple Watch.
Stappen:
1.Kies “Apple Pay” als betaalmethode.
2.Bevestig de betaling via Face ID, Touch ID of de Apple Watch.
4. Google Pay-integratie
Klanten kunnen Google Pay gebruiken om transacties veilig en snel af te ronden.
Werking:
Klanten bevestigen de betaling via hun Google Pay-account.
Stappen:
1.Kies “Google Pay” als betaalmethode.
2.Bevestig de betaling via het Google Pay-account van de klant.
5. Terugbetalingen (volledig & gedeeltelijk)
De Bluesnap-plugin ondersteunt zowel volledige als gedeeltelijke terugbetalingen voor transacties.
Werking:
Bij volledige terugbetalingen wordt het volledige betaalde bedrag terugbetaald.
Bij gedeeltelijke terugbetalingen wordt slechts een deel van het betaalde bedrag terugbetaald.
Stappen voor een volledige terugbetaling:
1.Ga naar het gedeelte Bestellingen.
2.Kies de bestelling die moet worden terugbetaald.
3.Klik op “Terugbetaling aanmaken”.
4.Wijzig de status in “In behandeling“.
Stappen voor een gedeeltelijke terugbetaling:
Ga naar het gedeelte Bestellingen.
Kies de bestelling die gedeeltelijk moet worden terugbetaald.
Geef het terug te betalen bedrag op.
Klik op “Terugbetaling aanmaken”.
Wijzig de status in “In behandeling”.
6. Functie “Kaart opslaan”
Met deze functie kunnen klanten hun kaartgegevens veilig opslaan voor toekomstige transacties.
Werking:
Er wordt een Vaulted-ID aangemaakt om de betaalgegevens van de klant veilig op te slaan.
Klanten kunnen opgeslagen kaarten kiezen voor toekomstige transacties.
Stappen:
Kies tijdens de checkout “Mijn kaart opslaan voor toekomstige betalingen”.
De kaart wordt veilig opgeslagen en is beschikbaar voor toekomstige betalingen.
7. Functie “Kaart bijwerken”
Stelt klanten in staat hun opgeslagen kaartgegevens veilig bij te werken voor toekomstige transacties.
Werking:
Klanten kunnen hun opgeslagen kaartgegevens rechtstreeks in de betaalgateway wijzigen.
Stappen:
Ga naar de checkout.
Werk de opgeslagen kaartgegevens bij.
Sla de bijgewerkte kaartgegevens op.
8. Functie “Kaart verwijderen”
Met deze functie kunnen klanten hun opgeslagen kaartgegevens verwijderen wanneer zij deze niet meer willen gebruiken.
Werking:
Klanten kunnen hun opgeslagen kaartgegevens uit het systeem verwijderen.
Stappen:
Ga naar de checkout.
Kies de kaart die moet worden verwijderd.
Klik op “Verwijderen” om de kaart uit het systeem te verwijderen.
9. 3D Secure-authenticatie
Het activeren van 3D Secure voegt een extra beveiligingslaag toe aan creditcardtransacties en vermindert fraude.
Werking:
Nadat de klant zijn creditcardgegevens heeft ingevoerd, wordt hij doorgestuurd naar de authenticatiepagina van zijn bank om de transactie af te ronden.
Stappen:
Activeer 3D Secure in de pluginconfiguratie.
Klanten worden tijdens de checkout automatisch gevraagd om 3D Secure-authenticatie.
Dit document biedt gedetailleerde informatie over de API-endpoints die beschikbaar zijn in de BlueSnap-plugin voor Shopware 6. Deze endpoints maken een veilige integratie met de betaaldiensten van BlueSnap mogelijk, waaronder het genereren van betalingstokens en het weergeven van gehoste betaalvelden binnen uw Shopware Storefront.
Endpoint:
POST /services/2/payment-fields-tokens
Beschrijving:
Dit endpoint wordt gebruikt om een Payment-Field-token te genereren, dat nodig is om de gehoste betaalvelden van BlueSnap veilig in de frontend weer te geven.
Request-headers:
Authorization: Basic
Succesvol antwoord:
HTTP/1.1 201 Created
Location: https://sandbox.bluesnap.com/services/2/payment-fields-tokens/eyJhbGciOiJIUzI1NiJ9...
Voorbeeld van een foutantwoord:
{
"errorCode": "401",
"errorDescription": "Unauthorized Error"
}
Endpoint:
POST /services/2/transactions
Beschrijving:
Dit endpoint wordt gebruikt om een betaling voor een transactie via BlueSnap vast te leggen (autoriseren en geldmiddelen incasseren). Het wordt doorgaans aangeroepen nadat de betaalgegevens zijn getokeniseerd via de gehoste BlueSnap-velden.
Request-headers:
Authorization: Basic
Content-Type: application/json
Voorbeeld van een request body:
{
"amount": 39.98,
"softDescriptor": "Card Capture",
"currency": "EUR",
"cardHolderInfo": {
"firstName": "asd",
"lastName": "asd",
"zip": "12345",
"country": "us",
"city": "test",
"email": "tst@test.com"
},
"pfToken": "token",
"cardTransactionType": "AUTH_CAPTURE",
"transactionInitiator": "SHOPPER"
}
Succesvol antwoord:
{
"transactionId": 100123456,
"transactionType": "AUTH_CAPTURE",
"amount": 39.98,
"currency": "EUR",
"card": {
"cardLastFourDigits": "1111",
"cardType": "VISA"
},
"processingInfo": {
"processingStatus": "SUCCESS",
"authCode": "XYZ123"
}
}
Voorbeeld van een foutantwoord:
{
"errorCode": "401",
"errorDescription": "Unauthorized Error"
}
Endpoint:
POST /services/2/wallets/
Dit endpoint wordt gebruikt om een Apple Wallet-item voor een klant aan te maken of bij te werken. Het vereist doorgaans autorisatie en een JSON-payload met de walletgegevens. De aanvraag stuurt betaal- of passgerelateerde informatie naar de Apple Wallet-service van BlueSnap.
Request-headers:
Authorization: Basic
Content-Type: application/json
Voorbeeld van een request body:
{
"walletType": "APPLE_PAY",
"validationUrl": "https://apple-pay-gateway-cert.apple.com/paymentservices/startSession",
"domainName": "merchant.com"
}
Succesvol antwoord:
{
"walletType": "APPLE_PAY",
"walletToken": "ImRhdGEiOiJuY1AvRitIUy8zeG5ISk1pSm9RbXhCMFd"
}
Voorbeeld van een foutantwoord:
{
"message": "Invalid wallet request",
"code": 400
}
Endpoint:
GET /services/2/vaulted-shoppers/{vaultedShopperId}
Beschrijving:
Dit endpoint haalt de gegevens van een Vaulted Shopper bij BlueSnap op aan de hand van de unieke ID. Vaulted Shoppers slaan betaalgegevens en persoonlijke informatie op voor toekomstige transacties (bijv. abonnementen of opgeslagen betaalmethoden). Dit endpoint wordt doorgaans gebruikt om opgeslagen shopper-gegevens veilig te beheren of opnieuw te gebruiken.
Request-headers:
Authorization: Basic
Content-Type: application/json
Accept: application/json
Voorbeeld van een request:
GET /services/2/vaulted-shoppers/123456789
Succesvol antwoord:
{
"vaultedShopperId": 123456789,
"firstName": "John",
"lastName": "Doe",
"email": "john.doe@example.com",
"paymentSources": {
"creditCardInfo": [
{
"cardLastFourDigits": "1111",
"cardType": "VISA",
"expirationMonth": "12",
"expirationYear": "2025"
}
]
},
"billingContactInfo": {
"zip": "12345",
"country": "US",
"state": "CA",
"city": "Los Angeles",
"address": "123 Main St"
}
}
Voorbeeld van een foutantwoord:
{
"error": true,
"code": 15001,
"message": "Vaulted Shopper nicht gefunden."
}
Probleem: betaalmethode wordt niet weergegeven in de checkout
Probleem: 3D Secure wordt niet geactiveerd
Probleem: opgeslagen kaarten worden niet weergegeven
Probleem: terugbetaling mislukt of wordt niet weergegeven in de bestelstatus
1. Welke betaalmethoden ondersteunt de Bluesnap Shopware 6 plugin?
De plugin ondersteunt creditcard, Apple Pay, Google Pay, Hosted Checkout en Pay by Link.
2. Kunnen klanten hun kaartgegevens opslaan voor toekomstige betalingen?
Ja, klanten kunnen kaartgegevens veilig opslaan en deze binnen hun account beheren (bijwerken of verwijderen).
3. Hoe activeer ik 3D Secure?
U kunt 3D Secure activeren in de pluginconfiguratie-instellingen onder het API-gedeelte.
4. Wordt sandbox-testing ondersteund?
Ja, de plugin ondersteunt de sandbox-modus om veilig te testen. Gebruik de sandbox-API-sleutels in het configuratiegedeelte.
5. Kan ik gedeeltelijke terugbetalingen uitvoeren?
Ja, zowel volledige als gedeeltelijke terugbetalingen worden ondersteund via de bestelbeheerinterface.
Lees meer over de pluginconfiguratie in onze WIKI.
Lees meer over de pluginconfiguratie in onze WIKI