European Payment Methods - Dodo Payments Documentation

Acceptera iDEAL, Bancontact, EPS, Multibanco, BLIK, SEPA Direct Debit och Satispay för att nå europeiska kunder som föredrar att betala från sin bank eller en lokal betalningsapp i stället för med kort. På marknader där en lokal metod är det vanligaste sättet att betala online kan den öka konverteringen.

Why Local European Payment Methods?

Higher Conversion

iDEAL är den mest använda betalningsmetoden online i Nederländerna. Utan den förlorar du nederländska kunder som inte vill betala på något annat sätt.

Bank Authentication

För bankautentiserade metoder godkänner kunden betalningen i sin bankapp eller på sin banks webbplats.

Real-Time Settlement

De flesta metoder på den här sidan bekräftar betalningen under checkout. SEPA Direct Debit- och Multibanco ATM-betalningar bekräftas senare.

Metoder som stöds

Varje metod erbjuds endast när checkouten matchar dess valuta och faktureringstyp:

Method	Country	Currency	Subscriptions
iDEAL	Nederländerna	EUR	Nej
Bancontact	Belgien	EUR	Nej
EPS	Österrike	EUR	Nej
Multibanco	Portugal	EUR	Nej
BLIK	Polen	PLN	Nej
SEPA Direct Debit	Euroområdet	EUR	Nej
Satispay	Europa (Italien)	EUR	Ja

iDEAL (Nederländerna)

iDEAL är den mest använda betalningsmetoden online i Nederländerna. Den ansluter direkt till alla större nederländska banker, och kunden godkänner varje betalning med sin egen bank.

Så fungerar det

Kunden väljer iDEAL, väljer sin bank och autentiserar sig där:

Banker som stöds

iDEAL fungerar med alla större nederländska banker, inklusive:

ABN AMRO
ASN Bank
Bunq
ING
Knab
Rabobank
RegioBank
Revolut
SNS
Triodos Bank
Van Lanschot

Konfiguration

Om du vill erbjuda iDEAL inkluderar du ideal i allowed_payment_method_types och fakturerar i EUR:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['ideal', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'NL',
    zipcode: '1012JS'
  },
  return_url: 'https://example.com/success'
});

Bancontact (Belgien)

Bancontact är Belgiens nationella betalningssystem. Nästan alla belgiska banker använder det för onlinebetalningar.

Funktioner

Fungerar med de Bancontact-betalkort som belgiska kunder redan har
Stöder betalning i Bancontacts mobilapp
Bekräftar betalningen under checkout
Kräver ingen extra registrering från kunden

Konfiguration

Om du vill erbjuda Bancontact inkluderar du bancontact_card och fakturerar i EUR:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['bancontact_card', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'BE',
    zipcode: '1000'
  },
  return_url: 'https://example.com/success'
});

EPS (Österrike)

EPS (Electronic Payment Standard) låter österrikiska kunder betala med en onlinebanköverföring från sin egen bank.

Funktioner

Ansluter direkt till österrikiska banker
Bekräftar betalningen under checkout
Har högt förtroende bland österrikiska konsumenter

Banker som stöds

EPS fungerar med större österrikiska banker, inklusive:

Erste Bank
Bank Austria
Raiffeisen
BAWAG
Volksbank

Konfiguration

Om du vill erbjuda EPS inkluderar du eps och fakturerar i EUR:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['eps', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'AT',
    zipcode: '1010'
  },
  return_url: 'https://example.com/success'
});

Multibanco (Portugal)

Multibanco är Portugals interbanknätverk. Kunder kan betala online eller betala en betalningsreferens i en uttagsautomat.

Betalningsalternativ

Kunder kan slutföra en Multibanco-betalning på tre sätt:

Internetbank: En banköverföring via kundens internetbank.
Betalning i uttagsautomat: Kunden får en betalningsreferens och betalar den i valfri Multibanco-uttagsautomat.
Mobilbank: En betalning i kundens bankapp.

Så fungerar betalning i uttagsautomat

Vid betalning i en uttagsautomat får kunden en betalningsreferens som denna:

Entity: 12345
Reference: 123 456 789
Amount: €50.00

Kunden betalar med denna referens i valfri portugisisk uttagsautomat eller via internetbanken. Referensen är giltig under en begränsad tid, vilket visas för kunden tillsammans med referensen.

Konfiguration

Om du vill erbjuda Multibanco inkluderar du multibanco och fakturerar i EUR:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['multibanco', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'PT',
    zipcode: '1000-001'
  },
  return_url: 'https://example.com/success'
});

En Multibanco-betalning i uttagsautomat slutförs när kunden betalar referensen, vilket kan ske långt efter checkout. Använd webhooks för att få veta när betalningen har bekräftats.

BLIK (Polen)

BLIK är Polens populäraste mobila betalningsmetod. Kunden betalar med en engångskod på 6 siffror som genereras i bankappen. BLIK-betalningar faktureras i PLN (polska zloty), inte EUR.

Så fungerar det

Kunden genererar en kod i sin bankapp, anger den i checkout och godkänner betalningen i appen:

Tillgänglighet

Faktureringsvaluta: Endast PLN
Transaktionstyp: Endast engångsbetalningar. BLIK erbjuds inte för prenumerationer.
Täckning: Alla större polska banker som stöder BLIK

Konfiguration

Om du vill erbjuda BLIK inkluderar du blik och ställer in billing_currency på PLN:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['blik', 'credit', 'debit'],
  billing_currency: 'PLN',
  billing_address: {
    country: 'PL',
    zipcode: '00-001'
  },
  return_url: 'https://example.com/success'
});

BLIK kräver faktureringsvalutan PLN, och Dodo Payments fakturerar endast i PLN när Adaptive Currency är aktiverat. Aktivera Adaptive Currency så att polska kunder faktureras i PLN och BLIK blir tillgängligt.

SEPA Direct Debit (Euroområdet)

SEPA Direct Debit låter kunder i euroområdet betala från sitt bankkonto i stället för med kort. Det erbjuds i EUR-checkout för engångsbetalningar, men inte för prenumerationer, när faktureringslandet är Österrike, Belgien, Estland, Finland, Frankrike, Tyskland, Irland, Italien, Lettland, Litauen, Nederländerna, Portugal, Slovakien eller Spanien.

SEPA Direct Debit är inte omedelbart. Det kan ta upp till 6 bankdagar att bekräfta en betalning. Till skillnad från en kortbetalning innebär kundens godkännande i checkout inte att pengarna har överförts. Slutför inte ordern vid checkout-redirecten eller på payment.processing. Vänta på payment.succeeded-webhooken.

Så fungerar det

Kunden godkänner debiteringen i checkout och Dodo Payments hämtar sedan pengarna från kundens bankkonto. Banken behandlar debiteringen asynkront, så betalningen förblir i tillståndet processing tills den når ett slutligt resultat:

Betalningens tidslinje

En SEPA-betalning går igenom följande steg:

Steg	När	Betalningsstatus	Vad det betyder
Godkännande	Vid checkout	`processing`	Kunden godkände debiteringen och omdirigerades tillbaka. Pengarna har inte flyttats ännu, så slutför inte ordern.
Bekräftelse	Upp till 6 bankdagar senare	`succeeded`	Banken har behandlat debiteringen. Slutför ordern nu.
Misslyckande	Upp till 6 bankdagar senare	`failed`	Debiteringen kunde inte genomföras, till exempel på grund av otillräckliga medel. Slutför inte ordern och meddela kunden.

Bekräftelsen kommer flera dagar efter att kunden lämnat din webbplats, så det är din webhook-hanterare, inte checkout-redirecten, som måste ge åtkomst. Se Hantera bekräftelsefördröjningen.

Tillgänglighet

Faktureringsvaluta: EUR
Transaktionstyp: Endast engångsbetalningar. SEPA Direct Debit erbjuds inte för prenumerationer.

Konfiguration

Om du vill erbjuda SEPA Direct Debit inkluderar du sepa och fakturerar i EUR:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['sepa', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'DE',
    zipcode: '10115'
  },
  return_url: 'https://example.com/success'
});

SEPA-test-IBAN

I testläge anger du en av dessa IBAN-koder i checkout för att tvinga fram ett specifikt resultat:

Test-IBAN	Beteende
`DE89370400440532013000`	Betalningen lyckas.
`DE08370400440532013003`	Betalningen lyckas efter en fördröjning på minst tre minuter.
`DE62370400440532013001`	Betalningen misslyckas.
`DE78370400440532013004`	Betalningen misslyckas efter en fördröjning på minst tre minuter.
`DE35370400440532013002`	Betalningen lyckas och bestrids sedan omedelbart.
`DE65370400440002222227`	Betalningen misslyckas på grund av otillräckliga medel.
`DE18370400440000066666`	Bankkontot kan inte användas, så betalningsmetoden kan inte skapas.

Om du vill testa landsspecifikt beteende använder du en lyckad IBAN för ett annat land i euroområdet:

Land	Lyckad IBAN
Österrike	`AT611904300234573201`
Belgien	`BE62510007547061`
Estland	`EE382200221020145685`
Finland	`FI2112345600000785`
Frankrike	`FR1420041010050500013M02606`
Irland	`IE29AIBK93115212345678`
Luxemburg	`LU280019400644750000`

Använd test-IBAN-koderna med fördröjning för att bekräfta att det är din webhook-hanterare, inte checkout-redirecten, som ger åtkomst. SEPA-betalningar bekräftas långt efter att kunden lämnat checkout.

Hantera bekräftelsefördröjningen

SEPA slutförs upp till 6 bankdagar efter checkout, så webbläsarens redirect kan inte tala om huruvida betalningen har genomförts. Låt i stället webhook-händelser styra orderhanteringen. Aktivera händelsen type och hantera varje steg:

Händelsetyp	När den utlöses	Vad du ska göra
`payment.processing`	Kunden godkände debiteringen i checkout och omdirigerades tillbaka.	Slutför inte ordern. Markera ordern som väntande. Informera vid behov kunden om att betalningen behandlas.
`payment.succeeded`	Banken har behandlat debiteringen, upp till 6 bankdagar senare.	Slutför ordern: ge åtkomst, konfigurera produkten och skicka kvittot.
`payment.failed`	Debiteringen kunde inte genomföras.	Meddela kunden och be kunden försöka igen. Slutför inte ordern.

Slutför ordern vid payment.succeeded från webhooken, inte vid checkout-redirecten eller på payment.processing. Redirecten sker så snart kunden godkänner debiteringen, flera dagar innan pengarna överförs.

Följande Express-hanterare verifierar varje händelses signatur med client.webhooks.unwrap innan den agerar på händelsen. Information om hur du konfigurerar endpoints finns i Webhooks-guiden. Information om alla händelser finns i Webhook Event Guide.

Handling SEPA payment events

import express from 'express';
import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
});
const app = express();

// markOrderPending, fulfillOrder, and markOrderFailed are your own order functions.
app.post('/webhooks/dodo', express.raw({ type: 'application/json' }), async (req, res) => {
  let event;
  try {
    // Checks the webhook-id, webhook-signature, and webhook-timestamp headers.
    event = client.webhooks.unwrap(req.body.toString(), { headers: req.headers });
  } catch {
    return res.status(400).send('Invalid signature');
  }

  switch (event.type) {
    case 'payment.processing': {
      // SEPA debit authorized but NOT settled. This can last up to 6 business days.
      // Record the order as pending; do not grant access yet.
      await markOrderPending(event.data.payment_id);
      break;
    }
    case 'payment.succeeded': {
      // The debit cleared, so it's safe to fulfill now.
      await fulfillOrder(event.data.payment_id);
      break;
    }
    case 'payment.failed': {
      // The debit could not be collected (for example, insufficient funds).
      await markOrderFailed(event.data.payment_id);
      // Notify the customer and prompt a retry.
      break;
    }
  }

  res.json({ received: true });
});

Ställ in kundernas förväntningar i checkout. Åtkomst ges först när debiteringen har genomförts, så informera SEPA-kunder om att deras order behandlas och att du meddelar dem när betalningen har bekräftats. Annars kan de förvänta sig omedelbar åtkomst, precis som vid en kortbetalning.

Satispay (Europa)

Satispay är ett europeiskt mobilt betalningsnätverk med sin största användarbas i Italien. Kunder betalar från Satispay-appen utan att dela kort- eller bankuppgifter. Satispay-betalningar faktureras i EUR.

Funktioner

Appbaserade betalningar som inte är beroende av kortnätverk
Stark användning i Italien och växande användning på andra europeiska marknader
Stöd för både engångsbetalningar och prenumerationer

Tillgänglighet

Faktureringsvaluta: EUR
Transaktionstyp: Engångsbetalningar och prenumerationer
Belopp: Från €0.50 till €999,999.99 per betalning

Konfiguration

Om du vill erbjuda Satispay inkluderar du satispay och fakturerar i EUR:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: ['satispay', 'credit', 'debit'],
  billing_currency: 'EUR',
  billing_address: {
    country: 'IT',
    zipcode: '00100'
  },
  return_url: 'https://example.com/success'
});

API-metodtyper

Skicka dessa värden i allowed_payment_method_types:

Typ	Metod	Land
`ideal`	iDEAL	Nederländerna
`bancontact_card`	Bancontact	Belgien
`eps`	EPS	Österrike
`multibanco`	Multibanco	Portugal
`blik`	BLIK	Polen
`sepa`	SEPA Direct Debit	Euroområdet
`satispay`	Satispay	Europa (Italien)

Europeisk checkout i flera länder

Om du vill sälja i flera europeiska länder inkluderar du alla regionala metoder samt kort som reservalternativ:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  allowed_payment_method_types: [
    'ideal',           // Netherlands
    'bancontact_card', // Belgium
    'eps',             // Austria
    'multibanco',      // Portugal
    'blik',            // Poland (requires PLN billing currency)
    'sepa',            // Eurozone (one-time payments only)
    'satispay',        // Europe / Italy
    'credit',          // Fallback
    'debit'            // Fallback
  ],
  billing_currency: 'EUR',
  return_url: 'https://example.com/success'
});

Dodo Payments visar varje kund endast de metoder som matchar kundens faktureringsland och valuta. En nederländsk kund ser iDEAL och en belgisk kund ser Bancontact. Den här sessionen faktureras i EUR, så BLIK visas inte.

Testning

Du kan testa europeiska betalningsmetoder i testläge. Testflödet simulerar bankautentiseringssteget.

SEPA Direct Debit använder ett annat testflöde. I stället för ett simulerat bankflöde anger du en test-IBAN direkt. Se SEPA-test-IBAN.

Multibanco använder också ett annat testflöde. Checkout visar en värdeavi i stället för ett bankflöde, och e-postadressen du anger avgör resultatet. Se Multibanco-testmejl.

Enable Test Mode

Stäng av reglaget Live Mode i sidofältet i dashboarden och använd API-nycklar som skapats i testläge.

Set Appropriate Billing Address

Ange faktureringsadressens land så att det matchar betalningsmetoden:

NL för iDEAL
BE för Bancontact
AT för EPS
PT för Multibanco
PL för BLIK (med PLN som faktureringsvaluta)
IT för Satispay

Complete the Test Flow

Följ det simulerade bankautentiseringsflödet i testläge.

Multibanco-testmejl

När du klickar på Pay visar checkout en Multibanco-värdeavi. I testläge avgör e-postadressen du anger resultatet:

E-postadress	Resultat
Valfri e-postadress, till exempel `jenny@example.com`	Betalningen lyckas efter cirka 3 minuter.
`succeed_immediately@example.com`	Betalningen lyckas inom några sekunder.
`expire_immediately@example.com`	Betalningen misslyckas inom några sekunder.
`expire_with_delay@example.com`	Betalningen misslyckas efter cirka 3 minuter.
`fill_never@example.com`	Betalningen slutförs aldrig.

Om du vill se lyckad-sidan använder du succeed_immediately@example.com, väntar några sekunder och trycker på Done.

Bästa praxis

Always include regional methods for target markets

Om du säljer till nederländska kunder bör du inkludera iDEAL. Att utelämna det är som att inte acceptera Visa i USA: du förlorar en betydande andel av försäljningen.

Match currency to region

De flesta europeiska betalningsmetoder kräver EUR, så se till att din prissättning stöder transaktioner i EUR. Det enda undantaget är BLIK, som endast erbjuds med PLN (polska zloty) som faktureringsvaluta.

Handle redirects gracefully

De flesta europeiska metoder omdirigerar kunden till dennes bank eller betalningsapp. Se till att hanteringen av din return URL fungerar för kunder som avbryter flödet halvvägs.

Provide card fallbacks

Alla kunder i Europa kan inte använda dessa regionala metoder, till exempel turister och utlandsstationerade. Inkludera credit och debit som alternativ. Om ingen metod är tillgänglig misslyckas checkout-sessionen.

Consider Multibanco timing

En Multibanco-betalning via bankomat kan ta flera timmar att slutföra. Blockera inte leveransen i väntan på omedelbar betalning. Använd webhooks för asynkron bekräftelse.

Account for the SEPA 6-day delay

SEPA Direct Debit tar upp till 6 bankdagar att bekräfta. Slutför inte leveransen baserat på omdirigeringen från checkout eller på payment.processing. Bevilja åtkomst endast från webhooken payment.succeeded och informera kunderna i checkout om att deras beställning väntar. Se Hantera bekräftelsefördröjningen.

Felsökning

European method not appearing

Kontrollera:

Matchar kundens faktureringsland metodens land?
Är faktureringsvalutan EUR, eller PLN för BLIK?
Ingår metoden i allowed_payment_method_types?
Gäller checkout en engångsbetalning? iDEAL, Bancontact, EPS, Multibanco, BLIK och SEPA Direct Debit erbjuds inte för prenumerationer.

Lösning: Landsspecifika metoder visas endast för det egna landet. En kund med faktureringslandet DE (Tyskland) ser inte iDEAL, som endast finns i Nederländerna.

Bank authentication failed

Orsaker:

Kunden avbröt under bankautentiseringen.
Bankens autentiseringssystem var tillfälligt otillgängligt.
Kunden angav felaktiga inloggningsuppgifter.

Lösning: Kunden bör försöka igen. Om felet kvarstår kan du föreslå en annan betalningsmetod.

Redirect not completing

Orsaker:

Kunden stängde webbläsaren under bankomdirigeringen.
Ett nätverksproblem avbröt autentiseringen.
Return URL är felkonfigurerad.

Lösning: Kontrollera att din return URL är korrekt och nåbar samt att den hanterar både lyckade och misslyckade tillstånd.

Multibanco payment pending

Orsak: Kunden fick en betalningsreferens men har ännu inte betalat.Lösning: Detta är förväntat för bankomatbetalningar. Vänta på bekräftelsen via webhook. Referensen upphör att gälla efter den begränsade tid som visas för kunden.

SEPA payment stuck in processing

Orsak: SEPA Direct Debit clearas asynkront via kundens bank.Lösning: Detta är förväntat. Ett tillstånd med payment.processing kan vara i upp till 6 bankdagar innan debiteringen clearas. Vänta på den slutliga webhooken payment.succeeded (slutför leveransen) eller webhooken payment.failed (slutför inte leveransen). Betrakta inte omdirigeringen från checkout som en bekräftelse. Se Hantera bekräftelsefördröjningen.

Relaterade sidor

Payment Methods Overview

Se alla betalningsmetoder som stöds.

Adaptive Currency

Valutastöd och automatisk konvertering.

Checkout Guide

Fullständig guide för checkout-implementering.

Webhooks

Hantera betalningsbekräftelser asynkront.

​Why Local European Payment Methods?

Higher Conversion

Bank Authentication

Real-Time Settlement

​Metoder som stöds

​iDEAL (Nederländerna)

​Så fungerar det

​Banker som stöds

​Konfiguration

​Bancontact (Belgien)

​Funktioner

​Konfiguration

​EPS (Österrike)

​Funktioner

​Banker som stöds

​Konfiguration

​Multibanco (Portugal)

​Betalningsalternativ

​Så fungerar betalning i uttagsautomat

​Konfiguration

​BLIK (Polen)

​Så fungerar det

​Tillgänglighet

​Konfiguration

​SEPA Direct Debit (Euroområdet)

​Så fungerar det

​Betalningens tidslinje

​Tillgänglighet

​Konfiguration

​SEPA-test-IBAN

​Hantera bekräftelsefördröjningen

​Satispay (Europa)

​Funktioner

​Tillgänglighet

​Konfiguration

​API-metodtyper

​Europeisk checkout i flera länder

​Testning

​Multibanco-testmejl

​Bästa praxis

​Felsökning

​Relaterade sidor

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Why Local European Payment Methods?

Metoder som stöds

iDEAL (Nederländerna)

Så fungerar det

Banker som stöds

Konfiguration

Bancontact (Belgien)

Funktioner

Konfiguration

EPS (Österrike)

Funktioner

Banker som stöds

Konfiguration

Multibanco (Portugal)

Betalningsalternativ

Så fungerar betalning i uttagsautomat

Konfiguration

BLIK (Polen)

Så fungerar det

Tillgänglighet

Konfiguration

SEPA Direct Debit (Euroområdet)

Så fungerar det

Betalningens tidslinje

Tillgänglighet

Konfiguration

SEPA-test-IBAN

Hantera bekräftelsefördröjningen

Satispay (Europa)

Funktioner

Tillgänglighet

Konfiguration

API-metodtyper

Europeisk checkout i flera länder

Testning

Multibanco-testmejl

Bästa praxis

Felsökning

Relaterade sidor