Métodos de Pagamento Europeus - Dodo Payments Documentation

Aceite iDEAL, Bancontact, EPS, Multibanco, BLIK, SEPA Direct Debit e Satispay para alcançar clientes europeus que preferem pagar pelo banco ou por um aplicativo de pagamento local em vez de usar um cartão. Em mercados onde um método local é a forma mais comum de pagar online, oferecê-lo pode aumentar a conversão.

Por Que Métodos de Pagamento Locais Europeus?

Higher Conversion

iDEAL é o método de pagamento online mais usado nos Países Baixos. Sem ele, você perde clientes neerlandeses que não pagarão de outra forma.

Bank Authentication

Para métodos autenticados pelo banco, o cliente aprova o pagamento no aplicativo bancário ou no site do banco.

Real-Time Settlement

A maioria dos métodos nesta página confirma o pagamento durante o checkout. SEPA Direct Debit e os pagamentos em caixas eletrônicos do Multibanco são confirmados posteriormente.

Métodos compatíveis

Cada método é oferecido somente quando o checkout corresponde à sua moeda e ao seu tipo de cobrança:

Método	País	Moeda	Assinaturas
iDEAL	Países Baixos	EUR	Não
Bancontact	Bélgica	EUR	Não
EPS	Áustria	EUR	Não
Multibanco	Portugal	EUR	Não
BLIK	Polônia	PLN	Não
SEPA Direct Debit	Zona do euro	EUR	Sim
Satispay	Europa (Itália)	EUR	Sim

iDEAL (Países Baixos)

iDEAL é o método de pagamento online mais usado nos Países Baixos. Ele se conecta diretamente a todos os principais bancos neerlandeses, e o cliente aprova cada pagamento com o próprio banco.

Como funciona

O cliente seleciona iDEAL, escolhe o banco e faz a autenticação nele:

Bancos compatíveis

iDEAL funciona com todos os principais bancos neerlandeses, incluindo:

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

Configuração

Para oferecer iDEAL, inclua ideal em allowed_payment_method_types e faça a cobrança em 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 (Bélgica)

Bancontact é o sistema de pagamentos nacional da Bélgica. Quase todos os bancos belgas o utilizam para pagamentos online.

Recursos

Funciona com os cartões de débito Bancontact que os clientes belgas já possuem
Permite pagamentos no aplicativo móvel Bancontact
Confirma o pagamento durante o checkout
Não exige cadastro adicional do cliente

Configuração

Para oferecer Bancontact, inclua bancontact_card e faça a cobrança em 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 (Áustria)

EPS (Electronic Payment Standard) permite que clientes austríacos paguem por transferência bancária online usando o próprio banco.

Recursos

Conecta-se diretamente aos bancos austríacos
Confirma o pagamento durante o checkout
Tem alta confiança entre os consumidores austríacos

Bancos compatíveis

EPS funciona com os principais bancos austríacos, incluindo:

Erste Bank
Bank Austria
Raiffeisen
BAWAG
Volksbank

Configuração

Para oferecer EPS, inclua eps e faça a cobrança em 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 é a rede interbancária de Portugal. Os clientes podem pagar online ou pagar uma referência de pagamento em um caixa eletrônico.

Opções de pagamento

Os clientes podem concluir um pagamento Multibanco de três formas:

Internet banking: uma transferência bancária pelo banco online do cliente.
Pagamento em caixa eletrônico: o cliente recebe uma referência de pagamento e paga em qualquer caixa eletrônico Multibanco.
Mobile banking: um pagamento no aplicativo bancário do cliente.

Como funciona o pagamento em caixa eletrônico

Para um pagamento em caixa eletrônico, o cliente recebe uma referência de pagamento como esta:

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

O cliente paga usando essa referência em qualquer caixa eletrônico português ou pelo internet banking. A referência é válida por tempo limitado, que é mostrado ao cliente junto com a referência.

Configuração

Para oferecer Multibanco, inclua multibanco e faça a cobrança em 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'
});

Um pagamento Multibanco em caixa eletrônico é concluído quando o cliente paga a referência, o que pode ocorrer bem depois do checkout. Use webhooks para saber quando o pagamento for confirmado.

BLIK (Polônia)

BLIK é o método de pagamento móvel mais popular da Polônia. O cliente paga com um código único de 6 dígitos gerado no aplicativo bancário. Os pagamentos BLIK são cobrados em PLN (złoty polonês), não em EUR.

Como funciona

O cliente gera um código no aplicativo bancário, insere-o no checkout e aprova o pagamento no aplicativo:

Disponibilidade

Moeda de cobrança: somente PLN
Tipo de transação: somente pagamentos únicos. BLIK não é oferecido para assinaturas.
Cobertura: todos os principais bancos poloneses compatíveis com BLIK

Configuração

Para oferecer BLIK, inclua blik e defina billing_currency como 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 exige uma moeda de cobrança PLN, e Dodo Payments faz cobranças em PLN somente quando Adaptive Currency está habilitado. Habilite Adaptive Currency para que os clientes poloneses sejam cobrados em PLN e o BLIK fique disponível.

SEPA Direct Debit (Zona do euro)

SEPA Direct Debit permite que clientes da Zona do euro paguem pela conta bancária em vez de usar um cartão. Ele é oferecido em checkouts em EUR, tanto para pagamentos únicos quanto para assinaturas, quando o país de cobrança é Áustria, Bélgica, Estônia, Finlândia, França, Alemanha, Irlanda, Itália, Letônia, Lituânia, Países Baixos, Portugal, Eslováquia ou Espanha.

SEPA Direct Debit não é instantâneo. Um pagamento pode levar até 6 dias úteis para ser confirmado. Diferentemente de um pagamento com cartão, a autorização do cliente no checkout não significa que o dinheiro foi compensado. Não conclua o processamento do pedido no redirecionamento do checkout nem em payment.processing. Aguarde o webhook payment.succeeded.

Como funciona

O cliente autoriza o débito no checkout, e Dodo Payments coleta os fundos da conta bancária dele. O banco compensa o débito de forma assíncrona, portanto o pagamento permanece no estado processing até chegar a um resultado final:

Cronograma do pagamento

Um pagamento SEPA passa pelas seguintes etapas:

Etapa	Quando	Status do pagamento	O que significa
Autorização	No checkout	`processing`	O cliente aprovou o débito e foi redirecionado de volta. O dinheiro ainda não foi movimentado, portanto não conclua o processamento.
Confirmação	Até 6 dias úteis depois	`succeeded`	O banco compensou o débito. Conclua o processamento do pedido agora.
Falha	Até 6 dias úteis depois	`failed`	Não foi possível coletar o débito, por exemplo, devido a fundos insuficientes. Não conclua o processamento e notifique o cliente.

A confirmação chega dias depois que o cliente sai do seu site, portanto o seu handler de webhook, e não o redirecionamento do checkout, deve conceder acesso. Consulte Como lidar com o atraso na confirmação.

Disponibilidade

Moeda de cobrança: EUR
Tipo de transação: pagamentos únicos e assinaturas

Configuração

Para oferecer SEPA Direct Debit, inclua sepa e faça a cobrança em 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'
});

IBANs de teste do SEPA

No modo de teste, insira um destes IBANs no checkout para forçar um resultado específico:

IBAN de teste	Comportamento
`DE89370400440532013000`	O pagamento é bem-sucedido.
`DE08370400440532013003`	O pagamento é bem-sucedido após um atraso de pelo menos três minutos.
`DE62370400440532013001`	O pagamento falha.
`DE78370400440532013004`	O pagamento falha após um atraso de pelo menos três minutos.
`DE35370400440532013002`	O pagamento é bem-sucedido e imediatamente contestado.
`DE65370400440002222227`	O pagamento falha devido a fundos insuficientes.
`DE18370400440000066666`	A conta bancária não pode ser usada, portanto o método de pagamento não pode ser criado.

Para testar o comportamento específico de cada país, use o IBAN de sucesso de outro país da Zona do euro:

País	IBAN de sucesso
Áustria	`AT611904300234573201`
Bélgica	`BE62510007547061`
Estônia	`EE382200221020145685`
Finlândia	`FI2112345600000785`
França	`FR1420041010050500013M02606`
Irlanda	`IE29AIBK93115212345678`
Luxemburgo	`LU280019400644750000`

Use os IBANs de teste com atraso para confirmar que o seu handler de webhook, e não o redirecionamento do checkout, concede acesso. Os pagamentos SEPA são confirmados muito depois que o cliente sai do checkout.

Como lidar com o atraso na confirmação

O SEPA é liquidado até 6 dias úteis após o checkout, portanto o redirecionamento do navegador não pode informar se o pagamento foi compensado. Em vez disso, conduza o processamento pelos eventos de webhook. Ative o evento type e trate cada etapa:

Tipo de evento	Quando é disparado	O que fazer
`payment.processing`	O cliente autorizou o débito no checkout e foi redirecionado de volta.	Não conclua o processamento. Marque o pedido como pendente. Opcionalmente, informe ao cliente que o pagamento está sendo processado.
`payment.succeeded`	O banco compensou o débito, até 6 dias úteis depois.	Conclua o processamento do pedido: conceda acesso, provisione o produto e envie o recibo.
`payment.failed`	Não foi possível coletar o débito.	Notifique o cliente e solicite uma nova tentativa. Não conclua o processamento.

Conclua o processamento em payment.succeeded a partir do webhook, não no redirecionamento do checkout nem em payment.processing. O redirecionamento ocorre assim que o cliente autoriza o débito, dias antes de o dinheiro ser compensado.

O handler Express a seguir verifica a assinatura de cada evento com client.webhooks.unwrap antes de agir sobre o evento. Para configurar o endpoint, consulte o guia de Webhooks. Para ver todos os eventos, consulte o Guia de eventos de Webhook.

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 });
});

Defina as expectativas do cliente no checkout. O acesso só é concedido depois que o débito é compensado, portanto informe aos clientes do SEPA que o pedido está sendo processado e que você os notificará quando o pagamento for confirmado. Caso contrário, eles podem esperar acesso imediato, como ocorre com um pagamento com cartão.

Satispay (Europa)

Satispay é uma rede europeia de pagamentos móveis com sua maior base de usuários na Itália. Os clientes pagam pelo aplicativo Satispay sem compartilhar dados do cartão ou do banco. Os pagamentos Satispay são cobrados em EUR.

Recursos

Pagamentos baseados em aplicativo que não dependem de redes de cartões
Forte adoção na Itália e uso crescente em outros mercados europeus
Suporte para pagamentos únicos e assinaturas

Disponibilidade

Moeda de cobrança: EUR
Tipo de transação: pagamentos únicos e assinaturas
Valor: de €0,50 a €999.999,99 por pagamento

Configuração

Para oferecer Satispay, inclua satispay e faça a cobrança em 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'
});

Tipos de método da API

Envie estes valores em allowed_payment_method_types:

Tipo	Método	País
`ideal`	iDEAL	Países Baixos
`bancontact_card`	Bancontact	Bélgica
`eps`	EPS	Áustria
`multibanco`	Multibanco	Portugal
`blik`	BLIK	Polônia
`sepa`	SEPA Direct Debit	Zona do euro
`satispay`	Satispay	Europa (Itália)

Checkout europeu para vários países

Para vender em vários países europeus, inclua todos os métodos regionais, além de cartões como alternativa:

// `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 and subscriptions)
    'satispay',        // Europe / Italy
    'credit',          // Fallback
    'debit'            // Fallback
  ],
  billing_currency: 'EUR',
  return_url: 'https://example.com/success'
});

Dodo Payments mostra a cada cliente somente os métodos que correspondem ao país de cobrança e à moeda dele. Um cliente neerlandês vê iDEAL, e um cliente belga vê Bancontact. Esta sessão faz a cobrança em EUR, portanto BLIK não aparece.

Testes

Você pode testar métodos de pagamento europeus no modo de teste. O fluxo de teste simula a etapa de autenticação bancária.

SEPA Direct Debit usa um fluxo de teste diferente. Em vez de um fluxo bancário simulado, você insere diretamente um IBAN de teste. Consulte IBANs de teste do SEPA.

Enable Test Mode

Desative a opção Live Mode na barra lateral do dashboard e use API keys criadas no modo de teste.

Set Appropriate Billing Address

Defina o país do endereço de cobrança para corresponder ao método de pagamento:

NL para iDEAL
BE para Bancontact
AT para EPS
PT para Multibanco
PL para BLIK (com moeda de cobrança PLN)
IT para Satispay

Complete the Test Flow

Siga o fluxo simulado de autenticação bancária no modo de teste.

Práticas recomendadas

Always include regional methods for target markets

Se você vende para clientes neerlandeses, inclua iDEAL. Deixá-lo de fora é como não aceitar Visa nos EUA: você perde uma parcela significativa das vendas.

Match currency to region

A maioria dos métodos de pagamento europeus exige EUR, portanto certifique-se de que seus preços aceitem transações em EUR. A única exceção é BLIK, oferecido somente com cobrança em PLN (złoty polonês).

Handle redirects gracefully

A maioria dos métodos europeus redireciona o cliente para o banco ou aplicativo de pagamento. Certifique-se de que o tratamento da URL de retorno funcione para clientes que abandonam o fluxo no meio.

Provide card fallbacks

Nem todos os clientes na Europa podem usar esses métodos regionais, como turistas e expatriados. Inclua credit e debit como alternativas. Se nenhum método estiver disponível, a sessão de checkout falhará.

Consider Multibanco timing

Um pagamento Multibanco em caixa eletrônico pode levar horas para ser concluído. Não bloqueie o processamento esperando um pagamento imediato. Use webhooks para a confirmação assíncrona.

Account for the SEPA 6-day delay

SEPA Direct Debit leva até 6 dias úteis para ser confirmado. Não conclua o processamento no redirecionamento do checkout nem em payment.processing. Conceda acesso somente a partir do webhook payment.succeeded e informe aos clientes no checkout que o pedido está pendente. Consulte Como lidar com o atraso na confirmação.

Solução de problemas

European method not appearing

Verifique:

O país de cobrança do cliente corresponde ao país do método?
A moeda de cobrança é EUR ou PLN para BLIK?
O método está incluído em allowed_payment_method_types?
O checkout é para um pagamento único? iDEAL, Bancontact, EPS, Multibanco e BLIK não são oferecidos para assinaturas.

Solução: Métodos específicos de cada país aparecem somente para o próprio país. Um cliente com país de cobrança DE (Alemanha) não vê iDEAL, que está disponível somente nos Países Baixos.

Bank authentication failed

Causas:

O cliente cancelou durante a autenticação bancária.
O sistema de autenticação do banco ficou temporariamente indisponível.
O cliente inseriu credenciais incorretas.

Solução: O cliente deve tentar novamente. Se a falha persistir, sugira outro método de pagamento.

Redirect not completing

Causas:

O cliente fechou o navegador durante o redirecionamento bancário.
Um problema de rede interrompeu a autenticação.
A URL de retorno está configurada incorretamente.

Solução: Verifique se a URL de retorno está correta e acessível e se trata os estados de sucesso e falha.

Multibanco payment pending

Causa: O cliente recebeu uma referência de pagamento, mas ainda não pagou.Solução: Isso é esperado para pagamentos em caixa eletrônico. Aguarde a confirmação do webhook. A referência expira após o tempo limitado mostrado ao cliente.

SEPA payment stuck in processing

Causa: SEPA Direct Debit é compensado de forma assíncrona pelo banco do cliente.Solução: Isso é esperado. Um estado payment.processing pode durar até 6 dias úteis antes de o débito ser compensado. Aguarde o webhook final payment.succeeded (concluir o processamento) ou payment.failed (não concluir o processamento). Não trate o redirecionamento do checkout como confirmação. Consulte Como lidar com o atraso na confirmação.

Páginas relacionadas

Payment Methods Overview

Veja todos os métodos de pagamento compatíveis.

Adaptive Currency

Suporte a moedas e conversão automática.

Checkout Guide

Guia completo de implementação do checkout.

Webhooks

Trate as confirmações de pagamento de forma assíncrona.

​Por Que Métodos de Pagamento Locais Europeus?

Higher Conversion

Bank Authentication

Real-Time Settlement

​Métodos compatíveis

​iDEAL (Países Baixos)

​Como funciona

​Bancos compatíveis

​Configuração

​Bancontact (Bélgica)

​Recursos

​Configuração

​EPS (Áustria)

​Recursos

​Bancos compatíveis

​Configuração

​Multibanco (Portugal)

​Opções de pagamento

​Como funciona o pagamento em caixa eletrônico

​Configuração

​BLIK (Polônia)

​Como funciona

​Disponibilidade

​Configuração

​SEPA Direct Debit (Zona do euro)

​Como funciona

​Cronograma do pagamento

​Disponibilidade

​Configuração

​IBANs de teste do SEPA

​Como lidar com o atraso na confirmação

​Satispay (Europa)

​Recursos

​Disponibilidade

​Configuração

​Tipos de método da API

​Checkout europeu para vários países

​Testes

​Práticas recomendadas

​Solução de problemas

​Páginas relacionadas

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

Por Que Métodos de Pagamento Locais Europeus?

Métodos compatíveis

iDEAL (Países Baixos)

Como funciona

Bancos compatíveis

Configuração

Bancontact (Bélgica)

Recursos

Configuração

EPS (Áustria)

Recursos

Bancos compatíveis

Configuração

Multibanco (Portugal)

Opções de pagamento

Como funciona o pagamento em caixa eletrônico

Configuração

BLIK (Polônia)

Como funciona

Disponibilidade

Configuração

SEPA Direct Debit (Zona do euro)

Como funciona

Cronograma do pagamento

Disponibilidade

Configuração

IBANs de teste do SEPA

Como lidar com o atraso na confirmação

Satispay (Europa)

Recursos

Disponibilidade

Configuração

Tipos de método da API

Checkout europeu para vários países

Testes

Práticas recomendadas

Solução de problemas

Páginas relacionadas