Free 15 min initial consultation directly with our experts.
Bluesnap-pluginet til Shopware 6 er en pålidelig betalingsløsning, der forbinder Bluesnap-gatewayen med din Shopware-webshop. Det understøtter flere betalingsmetoder som kreditkort, Apple Pay, Google Pay, Hosted Checkout og Pay by Link. Du kan håndtere hele eller delvise refusioner, aktivere 3D Secure for ekstra sikkerhed og give kunderne mulighed for at gemme, opdatere eller slette deres kortoplysninger. Med en overskuelig opsætning og sikre transaktioner hjælper pluginet virksomheder med at tilbyde en smidig og fleksibel betalingsoplevelse. Driver du webshop i Danmark, bør du tjekke hos BlueSnap, hvilke valutaer og kortmærker der understøttes for din konto. Lokale betalingsmetoder som MobilePay og Dankort er ikke en del af pluginets funktioner og kræver en separat løsning.
Vigtigste funktioner
Kom i gang
Installation og aktivering
1. Download
1. Åbn indstillingerne for pluginet
2. Generelle indstillinger
Før du bruger pluginet, skal du konfigurere API-nøgler og betalingsindstillinger:
1. Kreditkortbetaling (Credit Card Capture)
Funktionen gør det muligt for kunderne at gennemføre transaktioner med deres kreditkort via Bluesnaps PCI-kompatible betalingsgateway.
Sådan fungerer det:
Kunderne indtaster deres kortoplysninger i en sikker formular.
Betalingen behandles via Bluesnap-gatewayen.
Trin:
1. Vælg “Bluesnap kreditkort” som betalingsmetode.
2. Indtast kundens kortoplysninger i Bluesnap-formularen.
3. Send betalingen.
2. Hosted Checkout
Bluesnaps Hosted Checkout stiller en sikker checkout-side til rådighed, der hostes af Bluesnap, så du ikke selv skal behandle følsomme betalingsdata.
Sådan fungerer det:
Kunderne sendes videre til en sikker, hostet checkout-side.
Betalingerne behandles sikkert via Bluesnap.
Trin:
1. Vælg “Bluesnap Hosted Checkout” som betalingsmetode.
2. Kunden sendes videre til den hostede checkout-side.
3. Kunden gennemfører transaktionen på den hostede side.
3. Integration af Apple Pay
Bluesnap understøtter Apple Pay, så kunderne kan betale med et enkelt tryk på deres Apple-enhed.
Sådan fungerer det:
Kunderne godkender betalingen på deres Apple-enhed med Face ID, Touch ID eller Apple Watch.
Trin:
1. Vælg “Apple Pay” som betalingsmetode.
2. Bekræft betalingen med Face ID, Touch ID eller Apple Watch.
4. Integration af Google Pay
Kunderne kan bruge Google Pay til at gennemføre transaktioner hurtigt og sikkert.
Sådan fungerer det:
Kunderne godkender betalingen via deres Google Pay-konto.
Trin:
1. Vælg “Google Pay” som betalingsmetode.
2. Godkend betalingen via kundens Google Pay-konto.
5. Refusioner (hele og delvise)
Bluesnap-pluginet understøtter både hele og delvise refusioner af transaktioner.
Sådan fungerer det:
Ved en hel refusion tilbagebetales hele betalingsbeløbet.
Ved en delvis refusion tilbagebetales kun en del af betalingsbeløbet.
Trin for en hel refusion:
1. Gå til området Ordrer.
2. Vælg den ordre, der skal refunderes.
3. Klik på “Opret refusion”.
4. Skift status til “Under behandling“.
Trin for en delvis refusion:
Gå til området Ordrer.
Vælg den ordre, der skal refunderes delvist.
Angiv refusionsbeløbet.
Klik på “Opret refusion”.
Skift status til “Under behandling”.
6. Funktionen “Gem kort”
Funktionen gør det muligt for kunderne at gemme deres kortoplysninger sikkert til fremtidige transaktioner.
Sådan fungerer det:
Der oprettes et vaulted ID, som gemmer kundens betalingsoplysninger sikkert.
Kunderne kan vælge gemte kort ved fremtidige transaktioner.
Trin:
Vælg “Gem mit kort til fremtidige betalinger” under checkout.
Kortet gemmes sikkert og er klar til fremtidige betalinger.
7. Funktionen “Opdater kort”
Gør det muligt for kunderne at opdatere deres gemte kortoplysninger sikkert til fremtidige transaktioner.
Sådan fungerer det:
Kunderne kan ændre deres gemte kortoplysninger direkte i betalingsgatewayen.
Trin:
Gå til checkout.
Opdater de gemte kortoplysninger.
Gem de opdaterede kortoplysninger.
8. Funktionen “Slet kort”
Funktionen gør det muligt for kunderne at slette deres gemte kortoplysninger, når de ikke længere vil bruge dem.
Sådan fungerer det:
Kunderne kan fjerne deres gemte kortoplysninger fra systemet.
Trin:
Gå til checkout.
Vælg det kort, der skal slettes.
Klik på “Slet” for at fjerne kortet fra systemet.
9. 3D Secure-godkendelse
Når 3D Secure er aktiveret, får kreditkorttransaktioner et ekstra sikkerhedslag, og risikoen for svindel mindskes.
Sådan fungerer det:
Når kunden har indtastet sine kortoplysninger, sendes kunden videre til bankens godkendelsesside for at gennemføre transaktionen.
Trin:
Aktiver 3D Secure i pluginets konfiguration.
Kunderne bliver automatisk bedt om 3D Secure-godkendelse under checkout.
Dette afsnit giver detaljerede oplysninger om de API-endpoints, der er tilgængelige i BlueSnap-pluginet til Shopware 6. Endpoints muliggør en sikker integration med BlueSnaps betalingstjenester, herunder generering af betalingstokens og visning af hostede betalingsfelter i din Shopware-storefront.
Endpoint:
POST /services/2/payment-fields-tokens
Beskrivelse:
Dette endpoint bruges til at generere et payment field token, som er nødvendigt for at vise BlueSnaps hostede betalingsfelter sikkert i frontend.
Request-headere:
Authorization: Basic
Vellykket svar:
HTTP/1.1 201 Created
Location: https://sandbox.bluesnap.com/services/2/payment-fields-tokens/eyJhbGciOiJIUzI1NiJ9...
Eksempel på fejlsvar:
{
"errorCode": "401",
"errorDescription": "Unauthorized Error"
}
Endpoint:
POST /services/2/transactions
Beskrivelse:
Dette endpoint bruges til at gennemføre en betaling for en transaktion via BlueSnap (autorisere og trække beløbet). Det kaldes typisk, efter at betalingsoplysningerne er blevet tokeniseret via BlueSnaps hostede felter.
Request-headere:
Authorization: Basic
Content-Type: application/json
Eksempel på 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"
}
Vellykket svar:
{
"transactionId": 100123456,
"transactionType": "AUTH_CAPTURE",
"amount": 39.98,
"currency": "EUR",
"card": {
"cardLastFourDigits": "1111",
"cardType": "VISA"
},
"processingInfo": {
"processingStatus": "SUCCESS",
"authCode": "XYZ123"
}
}
Eksempel på fejlsvar:
{
"errorCode": "401",
"errorDescription": "Unauthorized Error"
}
Endpoint:
POST /services/2/wallets/
Dette endpoint bruges til at oprette eller opdatere en Apple Wallet-post for en kunde. Det kræver typisk autorisation og en JSON-payload, der beskriver wallet-dataene. Requesten sender betalings- eller pass-relaterede oplysninger til BlueSnaps Apple Wallet-tjeneste.
Request-headere:
Authorization: Basic
Content-Type: application/json
Eksempel på request body:
{
"walletType": "APPLE_PAY",
"validationUrl": "https://apple-pay-gateway-cert.apple.com/paymentservices/startSession",
"domainName": "merchant.com"
}
Vellykket svar:
{
"walletType": "APPLE_PAY",
"walletToken": "ImRhdGEiOiJuY1AvRitIUy8zeG5ISk1pSm9RbXhCMFd"
}
Eksempel på fejlsvar:
{
"message": "Invalid wallet request",
"code": 400
}
Endpoint:
GET /services/2/vaulted-shoppers/{vaultedShopperId}
Beskrivelse:
Dette endpoint henter data om en vaulted shopper hos BlueSnap ud fra det entydige ID. Vaulted shoppers gemmer betalingsoplysninger og personlige oplysninger til fremtidige transaktioner (f.eks. abonnementer eller gemte betalingsmetoder). Endpointet bruges typisk til at administrere eller genbruge gemte shopperdata på en sikker måde.
Request-headere:
Authorization: Basic
Content-Type: application/json
Accept: application/json
Eksempel på request:
GET /services/2/vaulted-shoppers/123456789
Vellykket svar:
{
"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"
}
}
Eksempel på fejlsvar:
{
"error": true,
"code": 15001,
"message": "Vaulted shopper blev ikke fundet."
}
Problem: Betalingsmetoden vises ikke i checkout
Problem: 3D Secure udløses ikke
Problem: Gemte kort vises ikke
Problem: Refusionen mislykkes eller vises ikke i ordrestatus
1. Hvilke betalingsmetoder understøtter Bluesnap-pluginet til Shopware 6?
Pluginet understøtter kreditkort, Apple Pay, Google Pay, Hosted Checkout og Pay by Link. MobilePay og Dankort, som mange kunder i Danmark forventer, er ikke en del af pluginet.
2. Kan kunderne gemme deres kortoplysninger til fremtidige betalinger?
Ja, kunderne kan gemme kortoplysninger sikkert og administrere dem (opdatere eller slette) på deres konto.
3. Hvordan aktiverer jeg 3D Secure?
Du kan aktivere 3D Secure i pluginets konfiguration under API-området.
4. Understøttes test i sandbox?
Ja, pluginet understøtter sandbox-tilstand til sikker test. Brug sandbox-API-nøglerne i konfigurationsområdet.
5. Kan jeg lave delvise refusioner?
Ja, både hele og delvise refusioner understøttes via ordreadministrationen.
Læs mere om konfigurationen af pluginet i vores WIKI. Har du brug for hjælp til betalingsopsætningen i en dansk Shopware-webshop, hjælper solution25 gerne.
Læs mere om konfigurationen af pluginet i vores WIKI