Métodos de Pago Europeos - Dodo Payments Documentation

Acepta iDEAL, Bancontact, EPS, Multibanco, BLIK, SEPA Direct Debit y Satispay para llegar a clientes europeos que prefieren pagar desde su banco o una aplicación de pago local en lugar de usar una tarjeta. En los mercados donde un método local es la forma más común de pagar en línea, ofrecerlo puede aumentar la conversión.

¿Por qué Métodos de Pago Europeos Locales?

Higher Conversion

iDEAL es el método de pago en línea más utilizado en los Países Bajos. Sin él, pierdes clientes neerlandeses que no pagarán de otra forma.

Bank Authentication

Para los métodos autenticados por banco, el cliente aprueba el pago en su aplicación bancaria o en el sitio web de su banco.

Real-Time Settlement

La mayoría de los métodos de esta página confirman el pago durante el checkout. SEPA Direct Debit y los pagos de Multibanco en cajeros automáticos se confirman más tarde.

Métodos compatibles

Cada método solo se ofrece cuando el checkout coincide con su moneda y tipo de facturación:

Método	País	Moneda	Suscripciones
iDEAL	Países Bajos	EUR	No
Bancontact	Bélgica	EUR	No
EPS	Austria	EUR	No
Multibanco	Portugal	EUR	No
BLIK	Polonia	PLN	No
SEPA Direct Debit	Zona euro	EUR	Sí
Satispay	Europa (Italia)	EUR	Sí

iDEAL (Países Bajos)

iDEAL es el método de pago en línea más utilizado en los Países Bajos. Se conecta directamente con los principales bancos neerlandeses y el cliente aprueba cada pago con su propio banco.

Cómo funciona

El cliente selecciona iDEAL, elige su banco y se autentica allí:

Bancos compatibles

iDEAL funciona con los principales bancos neerlandeses, entre ellos:

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

Configuración

Para ofrecer iDEAL, incluye ideal en allowed_payment_method_types y factura en 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 es el sistema de pago nacional de Bélgica. Casi todos los bancos belgas lo utilizan para pagos en línea.

Funciones

Funciona con las tarjetas de débito Bancontact que los clientes belgas ya tienen
Admite pagos en la aplicación móvil de Bancontact
Confirma el pago durante el checkout
No requiere registro adicional por parte del cliente

Configuración

Para ofrecer Bancontact, incluye bancontact_card y factura en 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 (Austria)

EPS (Electronic Payment Standard) permite a los clientes austriacos pagar mediante transferencia bancaria en línea desde su propio banco.

Funciones

Se conecta directamente con bancos austriacos
Confirma el pago durante el checkout
Goza de una gran confianza entre los consumidores austriacos

Bancos compatibles

EPS funciona con los principales bancos austriacos, entre ellos:

Erste Bank
Bank Austria
Raiffeisen
BAWAG
Volksbank

Configuración

Para ofrecer EPS, incluye eps y factura en 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 es la red interbancaria de Portugal. Los clientes pueden pagar en línea o pagar una referencia de pago en un cajero automático.

Opciones de pago

Los clientes pueden completar un pago de Multibanco de tres formas:

Banca en línea: Una transferencia bancaria a través de la banca por Internet del cliente.
Pago en cajero automático: El cliente recibe una referencia de pago y la abona en cualquier cajero Multibanco.
Banca móvil: Un pago en la aplicación bancaria del cliente.

Cómo funciona el pago en cajero automático

Para un pago en cajero automático, el cliente recibe una referencia de pago como esta:

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

El cliente paga con esta referencia en cualquier cajero automático portugués o mediante la banca en línea. La referencia es válida durante un tiempo limitado, que se muestra al cliente junto con la referencia.

Configuración

Para ofrecer Multibanco, incluye multibanco y factura en 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'
});

Un pago de Multibanco en cajero automático se completa cuando el cliente paga la referencia, lo que puede ocurrir bastante después del checkout. Usa webhooks para saber cuándo se confirma el pago.

BLIK (Polonia)

BLIK es el método de pago móvil más popular de Polonia. El cliente paga con un código de 6 dígitos de un solo uso que genera en su aplicación bancaria. Los pagos de BLIK se facturan en PLN (zloty polaco), no en EUR.

Cómo funciona

El cliente genera un código en su aplicación bancaria, lo introduce en el checkout y aprueba el pago en la aplicación:

Disponibilidad

Moneda de facturación: Solo PLN
Tipo de transacción: Solo pagos únicos. BLIK no se ofrece para suscripciones.
Cobertura: Todos los principales bancos polacos compatibles con BLIK

Configuración

Para ofrecer BLIK, incluye blik y establece billing_currency en 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 requiere una moneda de facturación PLN, y Dodo Payments factura en PLN únicamente cuando Adaptive Currency está habilitado. Habilita Adaptive Currency para que los clientes polacos reciban la factura en PLN y BLIK esté disponible.

SEPA Direct Debit (Zona euro)

SEPA Direct Debit permite a los clientes de la zona euro pagar desde su cuenta bancaria en lugar de usar una tarjeta. Se ofrece en checkouts en EUR, tanto para pagos únicos como para suscripciones, cuando el país de facturación es Austria, Bélgica, Estonia, Finlandia, Francia, Alemania, Irlanda, Italia, Letonia, Lituania, los Países Bajos, Portugal, Eslovaquia o España.

SEPA Direct Debit no es instantáneo. Un pago puede tardar hasta 6 días laborables en confirmarse. A diferencia de un pago con tarjeta, la autorización del cliente durante el checkout no significa que el dinero se haya liquidado. No completes el pedido en la redirección del checkout ni en payment.processing. Espera al webhook payment.succeeded.

Cómo funciona

El cliente autoriza el débito durante el checkout y Dodo Payments cobra los fondos de su cuenta bancaria. El banco liquida el débito de forma asíncrona, por lo que el pago permanece en el estado processing hasta alcanzar un resultado final:

Cronología del pago

Un pago SEPA pasa por estas etapas:

Etapa	Cuándo	Estado del pago	Qué significa
Autorización	Durante el checkout	`processing`	El cliente aprobó el débito y fue redirigido de vuelta. El dinero todavía no se ha transferido, así que no completes el pedido.
Confirmación	Hasta 6 días laborables después	`succeeded`	El banco liquidó el débito. Completa el pedido ahora.
Fallo	Hasta 6 días laborables después	`failed`	No se pudo cobrar el débito, por ejemplo, debido a fondos insuficientes. No completes el pedido y notifica al cliente.

La confirmación llega días después de que el cliente abandone tu sitio, por lo que tu controlador de webhook, no la redirección del checkout, debe conceder el acceso. Consulta Cómo gestionar el retraso de confirmación.

Disponibilidad

Moneda de facturación: EUR
Tipo de transacción: Pagos únicos y suscripciones

Configuración

Para ofrecer SEPA Direct Debit, incluye sepa y factura en 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'
});

IBAN de prueba de SEPA

En modo de prueba, introduce uno de estos IBAN en el checkout para forzar un resultado específico:

IBAN de prueba	Comportamiento
`DE89370400440532013000`	El pago se realiza correctamente.
`DE08370400440532013003`	El pago se realiza correctamente después de un retraso de al menos tres minutos.
`DE62370400440532013001`	El pago falla.
`DE78370400440532013004`	El pago falla después de un retraso de al menos tres minutos.
`DE35370400440532013002`	El pago se realiza correctamente y luego se impugna de inmediato.
`DE65370400440002222227`	El pago falla debido a fondos insuficientes.
`DE18370400440000066666`	La cuenta bancaria no se puede utilizar, por lo que no se puede crear el método de pago.

Para probar el comportamiento específico de cada país, utiliza el IBAN de éxito de otro país de la zona euro:

País	IBAN de éxito
Austria	`AT611904300234573201`
Bélgica	`BE62510007547061`
Estonia	`EE382200221020145685`
Finlandia	`FI2112345600000785`
Francia	`FR1420041010050500013M02606`
Irlanda	`IE29AIBK93115212345678`
Luxemburgo	`LU280019400644750000`

Usa los IBAN de prueba con retraso para confirmar que tu controlador de webhook, no la redirección del checkout, concede el acceso. Los pagos SEPA se confirman mucho después de que el cliente abandona el checkout.

Cómo gestionar el retraso de confirmación

SEPA se liquida hasta 6 días laborables después del checkout, por lo que la redirección del navegador no puede indicarte si el pago se ha liquidado. Gestiona la entrega a partir de los eventos de webhook. Activa el evento type y gestiona cada etapa:

Tipo de evento	Cuándo se activa	Qué hacer
`payment.processing`	El cliente autorizó el débito durante el checkout y fue redirigido de vuelta.	No completes el pedido. Marca el pedido como pendiente. Si quieres, informa al cliente de que su pago se está procesando.
`payment.succeeded`	El banco liquidó el débito, hasta 6 días laborables después.	Completa el pedido: concede el acceso, aprovisiona el producto y envía el recibo.
`payment.failed`	No se pudo cobrar el débito.	Notifica al cliente y solicita que vuelva a intentarlo. No completes el pedido.

Completa el pedido con payment.succeeded desde el webhook, no con la redirección del checkout ni con payment.processing. La redirección ocurre tan pronto como el cliente autoriza el débito, días antes de que se liquide el dinero.

El siguiente controlador de Express verifica la firma de cada evento con client.webhooks.unwrap antes de actuar sobre el evento. Para configurar el endpoint, consulta la guía de Webhooks. Para consultar todos los eventos, revisa la guía 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 });
});

Establece las expectativas del cliente durante el checkout. El acceso solo se concede después de que el débito se liquide, así que informa a los clientes de SEPA de que su pedido se está procesando y de que les avisarás cuando se confirme el pago. De lo contrario, podrían esperar acceso inmediato, como ocurre con un pago con tarjeta.

Satispay (Europa)

Satispay es una red europea de pagos móviles con su mayor base de usuarios en Italia. Los clientes pagan desde la aplicación de Satispay sin compartir los datos de su tarjeta o banco. Los pagos de Satispay se facturan en EUR.

Funciones

Pagos basados en una aplicación que no dependen de las redes de tarjetas
Gran adopción en Italia y uso creciente en otros mercados europeos
Compatibilidad con pagos únicos y suscripciones

Disponibilidad

Moneda de facturación: EUR
Tipo de transacción: Pagos únicos y suscripciones
Importe: De 0,50 € a 999.999,99 € por pago

Configuración

Para ofrecer Satispay, incluye satispay y factura en 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 de API

Pasa estos valores en allowed_payment_method_types:

Tipo	Método	País
`ideal`	iDEAL	Países Bajos
`bancontact_card`	Bancontact	Bélgica
`eps`	EPS	Austria
`multibanco`	Multibanco	Portugal
`blik`	BLIK	Polonia
`sepa`	SEPA Direct Debit	Zona euro
`satispay`	Satispay	Europa (Italia)

Checkout europeo para varios países

Para vender en varios países europeos, incluye todos los métodos regionales y las tarjetas 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 muestra a cada cliente únicamente los métodos que coinciden con su país y moneda de facturación. Un cliente neerlandés ve iDEAL y un cliente belga ve Bancontact. Esta sesión factura en EUR, por lo que BLIK no aparece.

Pruebas

Puedes probar los métodos de pago europeos en modo de prueba. El flujo de prueba simula el paso de autenticación bancaria.

SEPA Direct Debit utiliza un flujo de prueba diferente. En lugar de un flujo bancario simulado, introduces directamente un IBAN de prueba. Consulta IBAN de prueba de SEPA.

Enable Test Mode

Desactiva el interruptor Live Mode en la barra lateral del dashboard y utiliza claves de API creadas en modo de prueba.

Set Appropriate Billing Address

Establece el país de la dirección de facturación para que coincida con el método de pago:

NL para iDEAL
BE para Bancontact
AT para EPS
PT para Multibanco
PL para BLIK (con moneda de facturación PLN)
IT para Satispay

Complete the Test Flow

Sigue el flujo de autenticación bancaria simulado en modo de prueba.

Prácticas recomendadas

Always include regional methods for target markets

Si vendes a clientes neerlandeses, incluye iDEAL. Omitirlo es como no aceptar Visa en Estados Unidos: pierdes una parte importante de las ventas.

Match currency to region

La mayoría de los métodos de pago europeos requieren EUR, así que asegúrate de que tus precios admitan transacciones en EUR. La única excepción es BLIK, que solo se ofrece con facturación en PLN (zloty polaco).

Handle redirects gracefully

La mayoría de los métodos europeos redirigen al cliente a su banco o aplicación de pago. Asegúrate de que la gestión de la URL de retorno funcione para los clientes que abandonen el flujo a mitad del proceso.

Provide card fallbacks

No todos los clientes en Europa pueden utilizar estos métodos regionales, como los turistas y expatriados. Incluye credit y debit como alternativas. Si no hay ningún método disponible, la sesión de checkout falla.

Consider Multibanco timing

Un pago de Multibanco en cajero automático puede tardar horas en completarse. No bloquees la entrega esperando un pago inmediato. Usa webhooks para la confirmación asíncrona.

Account for the SEPA 6-day delay

SEPA Direct Debit puede tardar hasta 6 días laborables en confirmarse. No completes el pedido en la redirección del checkout ni en payment.processing. Concede el acceso únicamente desde el webhook payment.succeeded e informa a los clientes durante el checkout de que su pedido está pendiente. Consulta Cómo gestionar el retraso de confirmación.

Solución de problemas

European method not appearing

Comprueba:

¿El país de facturación del cliente coincide con el país del método?
¿La moneda de facturación es EUR o PLN para BLIK?
¿El método está incluido en allowed_payment_method_types?
¿El checkout corresponde a un pago único? iDEAL, Bancontact, EPS, Multibanco y BLIK no se ofrecen para suscripciones.

Solución: Los métodos específicos de cada país solo aparecen para su propio país. Un cliente cuyo país de facturación sea DE (Alemania) no verá iDEAL, que solo está disponible en los Países Bajos.

Bank authentication failed

Causas:

El cliente canceló durante la autenticación bancaria.
El sistema de autenticación del banco no estaba disponible temporalmente.
El cliente introdujo credenciales incorrectas.

Solución: El cliente debe volver a intentarlo. Si el fallo persiste, sugiere un método de pago diferente.

Redirect not completing

Causas:

El cliente cerró el navegador durante la redirección bancaria.
Un problema de red interrumpió la autenticación.
La URL de retorno está configurada incorrectamente.

Solución: Comprueba que la URL de retorno sea correcta y accesible, y que gestione tanto los estados de éxito como los de fallo.

Multibanco payment pending

Causa: El cliente recibió una referencia de pago, pero todavía no ha pagado.Solución: Esto es normal en los pagos en cajero automático. Espera la confirmación del webhook. La referencia caduca después del tiempo limitado que se muestra al cliente.

SEPA payment stuck in processing

Causa: SEPA Direct Debit se liquida de forma asíncrona a través del banco del cliente.Solución: Esto es normal. Un estado payment.processing puede durar hasta 6 días laborables antes de que se liquide el débito. Espera al webhook final payment.succeeded (completar el pedido) o al webhook payment.failed (no completar el pedido). No consideres la redirección del checkout como una confirmación. Consulta Cómo gestionar el retraso de confirmación.

Páginas relacionadas

Payment Methods Overview

Consulta todos los métodos de pago compatibles.

Adaptive Currency

Compatibilidad con monedas y conversión automática.

Checkout Guide

Guía completa de implementación del checkout.

Webhooks

Gestiona las confirmaciones de pago de forma asíncrona.

​¿Por qué Métodos de Pago Europeos Locales?

Higher Conversion

Bank Authentication

Real-Time Settlement

​Métodos compatibles

​iDEAL (Países Bajos)

​Cómo funciona

​Bancos compatibles

​Configuración

​Bancontact (Bélgica)

​Funciones

​Configuración

​EPS (Austria)

​Funciones

​Bancos compatibles

​Configuración

​Multibanco (Portugal)

​Opciones de pago

​Cómo funciona el pago en cajero automático

​Configuración

​BLIK (Polonia)

​Cómo funciona

​Disponibilidad

​Configuración

​SEPA Direct Debit (Zona euro)

​Cómo funciona

​Cronología del pago

​Disponibilidad

​Configuración

​IBAN de prueba de SEPA

​Cómo gestionar el retraso de confirmación

​Satispay (Europa)

​Funciones

​Disponibilidad

​Configuración

​Tipos de método de API

​Checkout europeo para varios países

​Pruebas

​Prácticas recomendadas

​Solución de problemas

​Páginas relacionadas

Payment Methods Overview

Adaptive Currency

Checkout Guide

Webhooks

¿Por qué Métodos de Pago Europeos Locales?

Métodos compatibles

iDEAL (Países Bajos)

Cómo funciona

Bancos compatibles

Configuración

Bancontact (Bélgica)

Funciones

Configuración

EPS (Austria)

Funciones

Bancos compatibles

Configuración

Multibanco (Portugal)

Opciones de pago

Cómo funciona el pago en cajero automático

Configuración

BLIK (Polonia)

Cómo funciona

Disponibilidad

Configuración

SEPA Direct Debit (Zona euro)

Cómo funciona

Cronología del pago

Disponibilidad

Configuración

IBAN de prueba de SEPA

Cómo gestionar el retraso de confirmación

Satispay (Europa)

Funciones

Disponibilidad

Configuración

Tipos de método de API

Checkout europeo para varios países

Pruebas

Prácticas recomendadas

Solución de problemas

Páginas relacionadas