Tarjetas de Crédito y Débito - Dodo Payments Documentation

Los pagos con tarjeta son la base de los pagos en línea, aceptados a nivel mundial y confiables por los clientes de todo el mundo. Dodo Payments soporta todas las principales redes de tarjetas con protección contra fraudes incorporada y cumplimiento de PCI.

Redes de Tarjetas Soportadas

Redes Globales

Red	Cobertura
Visa	Líder global, más de 4B de tarjetas en todo el mundo
Mastercard	Alcance global, características de seguridad sólidas
American Express	Tarjetahabientes premium, mayor gasto
Discover	Enfocado en EE. UU., creciendo globalmente
JCB	Líder en Japón, expandiéndose por Asia
UnionPay	Dominante en China, más de 8B de tarjetas
Diners Club	Viajeros internacionales premium

Redes Regionales

Red	Región
Interac	Red de débito de Canadá
Cartes Bancaires	Red nacional de Francia
Tarjetas Locales de Corea	Redes domésticas de Corea
Rupay	Red nacional de India

Configuración

Usa estos valores en allowed_payment_method_types:

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

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

Incluye tanto credit como debit a menos que tengas una razón específica para excluir una. Las tarjetas de débito son preferidas por muchos clientes y suelen tener tarifas más bajas.

Autenticación 3D Secure

3D Secure (3DS) añade una capa de autenticación que reduce fraudes y contracargos al verificar la identidad del tarjetahabiente.

Cuándo se Activa 3DS

3DS se activa automáticamente cuando:

Es requerido por la red de tarjetas
Es requerido por regulaciones regionales (por ejemplo, PSD2 en Europa)
La transacción es marcada como de alto riesgo

Forzar 3DS

Puedes requerir 3DS en todas las transacciones:

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

Habilitar 3DS para todas las transacciones reduce el fraude, pero puede disminuir ligeramente la conversión ya que algunos clientes abandonan durante la autenticación.

Manejo de Fallos de Autenticación

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

Estado	Significado	Qué hacer
`requires_customer_action`	El cliente debe completar un desafío 3DS	Hacer que el cliente complete la autenticación durante el pago
`requires_payment_method`	El cliente nunca proporcionó un método de pago (no ingresó detalles o abandonó el prompt) — generalmente una pérdida, no un rechazo	Volver a comprometer al cliente para completar el pago; ver Recuperación de Carrito Abandonado

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.

Consulte la referencia Fallos de Transacción para la acción recomendada para cada uno.

En el Pago vs. en la Renovación

En el pago (cliente presente): El cliente está presente, por lo que se muestra el desafío 3DS durante el pago. Si falla, pídales que lo intenten de nuevo o usen otra tarjeta.
En la renovación de suscripción (cliente no presente): El cliente no está presente, por lo que no se puede mostrar un desafío 3DS en tiempo real. Si una renovación requiere autenticación, la suscripción pasa a on_hold. Recupéralo solicitando al cliente que regrese y actualice su método de pago — consulte Manejo de Fallos de Pago y Dunning de Suscripción.

Métodos de Pago Guardados

Los clientes pueden guardar sus tarjetas para pagos futuros más rápidos. Original card numbers never stored. Dodo maneja toda la conformidad. Cards tied to specific customers.

Habilitar Tarjetas Guardadas

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

Compras con Un Solo Clic

// Get customer's saved payment methods
const methods = await client.customers.retrievePaymentMethods('cus_123');

// Use saved card for instant checkout
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_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

Region	Marca	Número de Tarjeta	Expiración	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

Region	Marca	Número de Tarjeta	Escenario
US	Visa	`4000000000000002`	Rechazo genérico
US	Mastercard	`4000000000009995`	Fondos insuficientes
India	Visa	`4706131211212123`	Rechazo genérico
India	Mastercard	`5105105105105100`	Rechazo genérico

Las tarjetas de prueba solo funcionan en modo de prueba. Nunca las use para transacciones de producción.

Seguridad y Conformidad

Característica	Descripción
PCI DSS Nivel 1	Nivel más alto de certificación
Tokenización	Números de tarjeta tokenizados inmediatamente
Puntuación de Fraude	Evaluación de riesgo en tiempo real
AVS	Servicio de Verificación de Dirección
Validación CVV	Verificación del código de seguridad
3D Secure	Autenticación del titular de la tarjeta

Mejores Prácticas

No restrinja los tipos de tarjetas a menos que sea necesario. Los clientes esperan que su tarjeta preferida funcione. Muestre los logotipos de Visa, Mastercard, Amex en su pago para generar confianza. Muestre mensajes de error claros. No exponga códigos de error sin procesar a los clientes. Los métodos de pago guardados aumentan significativamente la conversión para compras repetidas.

Solución de Problemas

Causas: Fondos insuficientes, tarjeta expirada, CVV incorrecto, protección contra fraudes del banco. Solución: Pida al cliente que verifique los detalles o pruebe con otra tarjeta. Busque el rechazo específico Error Code y su acción recomendada en la referencia Fallos de Transacción, y consulte Manejo de Fallos de Pago para el manejo programático. Causas: Cliente abandonó, sistema bancario no disponible, tiempo de espera agotado. Solución: Reintente o solicita al cliente que contacte a su banco. Consulte Manejo de Fallos de Autenticación para los estados de pago y códigos de rechazo involucrados. Causas: Tarjeta regional no soportada, restricciones prepagadas. Solución: El cliente debe intentar con otra tarjeta de una red principal.

Páginas Relacionadas

Todos los métodos de pago soportados. Compras con un solo clic con tarjetas guardadas. Guía completa de pruebas. Facturación recurrente con tarjetas.

​Redes de Tarjetas Soportadas

​Redes Globales

​Redes Regionales

​Configuración

​Autenticación 3D Secure

​Cuándo se Activa 3DS

​Forzar 3DS

​Manejo de Fallos de Autenticación

​En el Pago vs. en la Renovación

​Métodos de Pago Guardados

​Habilitar Tarjetas Guardadas

​Compras con Un Solo Clic

​Pruebas

​Seguridad y Conformidad

​Mejores Prácticas

​Solución de Problemas

​Páginas Relacionadas

Redes de Tarjetas Soportadas

Redes Globales

Redes Regionales

Configuración

Autenticación 3D Secure

Cuándo se Activa 3DS

Forzar 3DS

Manejo de Fallos de Autenticación

En el Pago vs. en la Renovación

Métodos de Pago Guardados

Habilitar Tarjetas Guardadas

Compras con Un Solo Clic

Pruebas

Seguridad y Conformidad

Mejores Prácticas

Solución de Problemas

Páginas Relacionadas