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 |
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 |
| 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. 
