Tarjetas de Crédito y Débito

Las tarjetas están disponibles en todos los checkouts de Dodo Payments, en todos los países y monedas compatibles. Dodo Payments acepta las principales redes de tarjetas, reemplaza los números de tarjeta por tokens y realiza las comprobaciones necesarias para los pagos con tarjeta, por lo que no tienes que gestionar datos de tarjeta sin procesar.

Redes de Tarjetas Soportadas

Dodo Payments acepta redes globales y varias redes regionales.

Redes globales

Red	Cobertura
Visa	Líder mundial, más de 4 mil millones de tarjetas en todo el mundo
Mastercard	Alcance mundial, sólidas funciones de seguridad
American Express	Titulares de tarjetas premium, mayor gasto
Discover	Enfocada en EE. UU., con expansión mundial
JCB	Líder en Japón, en expansión por Asia
UnionPay	Dominante en China
Diners Club	Viajeros internacionales premium

Redes regionales

Red	Región
Interac	Red de débito de Canadá
Cartes Bancaires	Red nacional de Francia
Korean Local Cards	Redes nacionales de Corea
Rupay	Red nacional de India

Configuración

Las tarjetas utilizan dos valores en allowed_payment_method_types:

Tipo	Descripción
`credit`	Todas las tarjetas de crédito
`debit`	Todas las tarjetas de débito

Esta sesión solo ofrece pagos con tarjeta:

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

Incluye tanto credit como debit, a menos que tengas un motivo específico para excluir uno. Muchos clientes prefieren pagar con tarjeta de débito.

Autenticación 3D Secure

3D Secure (3DS) solicita al banco del titular de la tarjeta que confirme su identidad, por ejemplo, mediante un código de un solo uso, una verificación biométrica o una aprobación en la aplicación del banco. Esto reduce el fraude y las devoluciones de cargos.

Cuándo se activa 3DS

Dodo Payments solicita 3DS cuando:

La red de tarjetas lo requiere.
Una regulación regional lo exige, como PSD2 en Europa.
La transacción se marca como de alto riesgo.

Forzar 3DS

Para requerir 3DS en todos los pagos con tarjeta de tu empresa, activa 3D Secure en Settings → Pricing. Para anular esa configuración en una sesión de checkout, pasa force_3ds:

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  force_3ds: true,
  return_url: 'https://example.com/success'
});

Requerir 3DS en cada transacción reduce el fraude, pero puede disminuir la conversión, ya que algunos clientes abandonan el checkout durante la autenticación.

Gestión de fallos de autenticación

Cuando un pago necesita autenticación 3DS, pasa por estados intermedios antes de completarse o fallar:

Estado	Significado	Qué hacer
`requires_customer_action`	El cliente debe completar un desafío 3DS	Haz que el cliente complete la autenticación durante el checkout
`requires_payment_method`	El cliente nunca proporcionó un método de pago (no introdujo los datos o abandonó la solicitud). Normalmente se trata de un abandono, no de un rechazo	Vuelve a contactar con el cliente para que complete el checkout. Consulta Recuperación de carritos abandonados

Si la autenticación no se completa, el pago falla con uno de estos códigos de rechazo:

AUTHENTICATION_FAILURE: no se pudo autenticar al cliente.
AUTHENTICATION_REQUIRED: se requiere autenticación, pero no se realizó.
AUTHENTICATION_TIMEOUT: el cliente no respondió a tiempo.

La referencia de Fallos de transacciones incluye la acción recomendada para cada código.

Durante el checkout frente a una renovación

Durante el checkout (cliente presente): El desafío 3DS aparece durante el checkout. Si falla, pide al cliente que lo vuelva a intentar o que utilice otra tarjeta.
En la renovación de una suscripción (cliente no presente): No se puede mostrar un desafío 3DS en tiempo real. Si una renovación requiere autenticación y falla, la suscripción pasa a on_hold, o primero a past_due si configuraste un periodo de gracia. Para recuperarla, solicita al cliente que regrese y actualice su método de pago. Consulta Gestión de fallos de pago y Gestión de impagos de suscripciones.

Métodos de pago guardados

Los clientes recurrentes pueden pagar con una tarjeta guardada de un checkout anterior.

Tokenized

Los números originales de las tarjetas nunca se almacenan.

PCI Compliant

Dodo Payments gestiona el cumplimiento de PCI.

Customer-Scoped

Cada tarjeta guardada pertenece a un solo cliente.

Activar tarjetas guardadas

Para mostrar las tarjetas guardadas de un cliente recurrente durante el checkout, pasa show_saved_payment_methods: true junto con el customer_id existente. El valor predeterminado es false.

// `client` is an initialized DodoPayments client.
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  show_saved_payment_methods: true,
  customer: { customer_id: 'cus_existing_123' },
  return_url: 'https://example.com/success'
});

Compras con un clic

Para cobrar una tarjeta guardada sin mostrar el checkout, pasa su payment_method_id junto con confirm: true y el customer_id existente. La sesión cobra directamente la tarjeta y no devuelve ningún checkout_url, por lo que debes utilizar webhooks para conocer el resultado del pago.

// `client` is an initialized DodoPayments client.
// Get the customer's saved payment methods
const methods = await client.customers.retrievePaymentMethods('cus_123');

// Charge the first saved card
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  customer: { customer_id: 'cus_123' },
  payment_method_id: methods.items[0].payment_method_id,
  confirm: true,
  return_url: 'https://example.com/success'
});

Pruebas

Utiliza estas tarjetas en el modo de prueba. Para obtener más datos de prueba, consulta Proceso de pruebas.

Successful Payments
Declined Payments

Región	Marca	Número de tarjeta	Vencimiento	CVV
US	Visa	`4242424242424242`	06/32	123
US	Mastercard	`5555555555554444`	06/32	123
India	Visa	`4576238912771450`	06/32	123
India	Mastercard	`5409162669381034`	06/32	123

Región	Marca	Número de tarjeta	Escenario
US	Visa	`4000000000000002`	Rechazo genérico
US	Visa	`4000000000009995`	Fondos insuficientes
India	Visa	`4706131211212123`	Rechazo genérico
India	Mastercard	`5105105105105100`	Rechazo genérico

Las tarjetas de prueba solo funcionan en el modo de prueba. En el modo activo, un pago realizado con una tarjeta de prueba falla.

Seguridad y cumplimiento

Dodo Payments aplica estas protecciones a los pagos con tarjeta:

Función	Descripción
PCI DSS Level 1	El nivel más alto de certificación PCI DSS
Tokenization	Los números de tarjeta se tokenizan al introducirlos
Fraud Scoring	Evaluación de riesgos en tiempo real
CVV Validation	Verificación del código de seguridad
3D Secure	Autenticación del titular de la tarjeta

Prácticas recomendadas

Accept all major networks

No restrinjas los tipos de tarjeta a menos que sea necesario. Los clientes esperan que su tarjeta preferida funcione.

Display card logos

Muestra los logotipos de Visa, Mastercard y Amex en tu sitio para generar confianza.

Handle declines gracefully

Muestra mensajes de error claros. No muestres códigos de error sin procesar a los clientes.

Enable saved cards for returning customers

Los métodos de pago guardados agilizan las compras repetidas para los clientes recurrentes.

Solución de problemas

Card declined

Causas: Fondos insuficientes, una tarjeta vencida, un CVV incorrecto o la protección antifraude del banco.Solución: Pide al cliente que compruebe sus datos o que pruebe con otra tarjeta. Busca el código de error del rechazo y su acción recomendada en la referencia de Fallos de transacciones. Consulta Gestión de fallos de pago para gestionar los rechazos en el código.

3DS authentication failed

Causas: El cliente abandonó el desafío, el sistema del banco no estaba disponible o el desafío agotó el tiempo de espera.Solución: Vuelve a intentarlo o pide al cliente que se ponga en contacto con su banco. Consulta Gestión de fallos de autenticación para conocer los estados de pago y los códigos de rechazo involucrados.

Card not supported

Causas: La red regional no es compatible o la tarjeta es una tarjeta prepago restringida.Solución: Pide al cliente que pruebe con una tarjeta de una red principal.

Páginas relacionadas

Payment Methods Overview

Todos los métodos de pago compatibles.

Upsells & Downsells

Compras con un clic mediante tarjetas guardadas.

Testing Process

Datos de prueba para todos los métodos de pago.

Subscriptions

Facturación recurrente con tarjetas.

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Redes de Tarjetas Soportadas

Redes globales

Redes regionales

Configuración

Autenticación 3D Secure

Cuándo se activa 3DS

Forzar 3DS

Gestión de fallos de autenticación

Durante el checkout frente a una renovación

Métodos de pago guardados

Tokenized

PCI Compliant

Customer-Scoped

Activar tarjetas guardadas

Compras con un clic

Pruebas

Seguridad y cumplimiento

Prácticas recomendadas

Solución de problemas

Páginas relacionadas

Payment Methods Overview

Upsells & Downsells

Testing Process

Subscriptions

​Redes de Tarjetas Soportadas

​Redes globales

​Redes regionales

​Configuración

​Autenticación 3D Secure

​Cuándo se activa 3DS

​Forzar 3DS

​Gestión de fallos de autenticación

​Durante el checkout frente a una renovación

​Métodos de pago guardados

Tokenized

PCI Compliant

Customer-Scoped

​Activar tarjetas guardadas

​Compras con un clic

​Pruebas

​Seguridad y cumplimiento

​Prácticas recomendadas

​Solución de problemas

​Páginas relacionadas

Payment Methods Overview

Upsells & Downsells

Testing Process

Subscriptions

Redes de Tarjetas Soportadas

Redes globales

Redes regionales

Configuración

Autenticación 3D Secure

Cuándo se activa 3DS

Forzar 3DS

Gestión de fallos de autenticación

Durante el checkout frente a una renovación

Métodos de pago guardados

Activar tarjetas guardadas

Compras con un clic

Pruebas

Seguridad y cumplimiento

Prácticas recomendadas

Solución de problemas

Páginas relacionadas