Cómo conectar una pasarela de pago a tu tienda en línea

Una pasarela de pago es el servicio que recibe el dinero del cliente (con tarjeta, transferencia bancaria u otros medios) y le avisa a tu tienda que el pago se aprobó, para que el pedido se confirme solo. Conectarla es lo que te permite dejar de revisar comprobantes a mano y vender a cualquier hora. Esta guía te enseña a elegir una pasarela de pago, conectarla a tu tienda y comprobar que todo funciona antes de cobrar dinero real.

Pasarela de pago vs. pago manual: cuándo usar cada una

Lo más común es ofrecer ambos: la pasarela para quien quiere pagar ya, y un método manual como respaldo. Para más sobre el pago manual, lee cómo cobrar con Nequi en tu tienda en línea.

Paso 1: elige la pasarela según tu país

No todas las pasarelas atienden todos los países. En Tutiendanueva, el catálogo depende del país de tu tienda:

Todas las pasarelas (Bold, Mercado Pago, Wompi, PayU, PayPal, Payphone, Recurrente, Stripe y Sistecrédito) están incluidas en Standard, Pro y Premium. Un resumen en pasarelas de pago, y una guía específica de Bold y de Mercado Pago.

Para decidir entre dos opciones, compara:

1. Medios de pago que aceptan tus clientes (tarjetas, PSE, billeteras, cuotas).
2. Comisión y costos fijos: consulta las tarifas vigentes en la propia pasarela, porque cambian con el tiempo y según el medio.
3. Plazo de desembolso: cuántos días tarda el dinero en llegar a tu cuenta.
4. Requisitos de alta: documentos, tipo de negocio, tiempo de aprobación.
5. Soporte y facilidad para atender reclamos (contracargos).

Paso 2: crea tu cuenta de comercio y reúne los documentos

Este es el paso que más tarda, y depende de la pasarela, no de tu tienda. Normalmente te piden:

• Identificación tuya o de tu empresa y datos tributarios según tu país.
• Datos de tu cuenta bancaria para recibir el dinero.
• Descripción de tu negocio y, a veces, la dirección de tu tienda.

Empieza este trámite cuanto antes, en paralelo con la carga de productos, porque la aprobación puede tomar días. Mientras tanto, activa un método manual para poder vender.

Paso 3: consigue tus llaves de pruebas

Cada pasarela te entrega credenciales para conectarla, y casi todas tienen un entorno de pruebas (sandbox) separado del real. Los datos exactos cambian según la pasarela:

• Bold: llave de identidad y llave secreta (panel de comercios de Bold → Integraciones).
• Wompi: llave pública, secreto de integridad y secreto de eventos.
• PayU: API Key, Merchant ID y Account ID.
• Stripe y PayPal: claves de API de prueba y de producción.
• Mercado Pago: no pide llaves; te lleva a iniciar sesión y autorizar.

Trátalas como contraseñas: no las compartas por chat ni las pegues en sitios que no sean tu panel.

Paso 4: conecta la pasarela en tu panel

En Tutiendanueva el proceso es el mismo para las pasarelas con formulario:

1. Entra a Medios de pago → Pasarelas de pago. Solo verás las de tu país.
2. Toca la pasarela y llena los campos con las llaves.
3. Deja marcada la casilla "Son llaves de pruebas (sandbox)", que viene activada por defecto.
4. Pulsa Conectar. Verás "Conectado (pruebas)".
5. En pasarelas como Wompi, además debes copiar la URL de eventos que muestra el panel y pegarla en el panel de la pasarela (en Wompi, una vez en el ambiente de pruebas y otra en producción). Es lo que permite que el pedido se confirme automáticamente.

Con Mercado Pago, en cambio, pulsas "Conectar con Mercado Pago", inicias sesión y autorizas: sin llaves que copiar.

Paso 5: haz pedidos de prueba completos

No te conformes con ver "Conectado". Haz esta secuencia desde tu celular:

1. Agrega un producto barato al carrito y elige la pasarela en el checkout.
2. Paga con las tarjetas o datos de prueba que documenta la pasarela (por ejemplo, Stripe y Recurrente publican una tarjeta de prueba 4242 4242 4242 4242).
3. Verifica que el pedido pasó a Confirmado solo.
4. Verifica que el stock se descontó.
5. Repite con un pago rechazado y comprueba qué ve el cliente.

Cómo se comporta el pedido en el flujo real, según la plataforma: el pedido nace pendiente; el stock se descuenta cuando el pago se aprueba; si el pago es rechazado, el cliente tiene 1 hora para reintentar antes de que el pedido se cancele; y si no completa el pago, el pedido con pasarela se cancela a las 24 horas.

Paso 6: pasa a producción

Este paso es donde muchos se equivocan. Cuando tengas todo aprobado:

1. Desconecta la pasarela de pruebas.
2. Vuelve a conectarla con las llaves reales, con la casilla de pruebas desmarcada.
3. Verifica que aparezca "Conectado" sin "(pruebas)".
4. Haz una compra real pequeña con tu propia tarjeta y confirma que el dinero aparece en el panel de la pasarela y, luego, en tu banco.
5. Si aplica, repite el registro de la URL de eventos en producción.

Si conectaste todo pero los pagos "no son reales", casi seguro dejaste la casilla de pruebas marcada.

Casos especiales que conviene saber

• Payphone (Ecuador): hoy la plataforma no confirma automáticamente sus pagos; debes verificar el pago en tu cuenta y confirmar el pedido en el panel antes de que se cumplan las 24 horas.
• Recurrente (Guatemala): la confirmación automática no está confirmada; verifica cada pago en tu cuenta y confirma a mano.
• Restaurantes: los pagos en línea con pasarelas son del plan Premium y solo con Wompi, Bold, Mercado Pago, Stripe y Recurrente.
• Si un pago aprobado llega tarde a un pedido que se canceló solo, el pedido se reactiva a Confirmado.

Estos detalles pueden cambiar con el tiempo; el panel de tu tienda muestra las instrucciones vigentes.

Errores comunes

• Quedarte en modo pruebas creyendo que ya cobras.
• No registrar la URL de eventos cuando la pasarela la pide: el cliente paga y el pedido sigue pendiente.
• No probar un pago rechazado.
• Ignorar la comisión en tus precios (ver cómo fijar precios y margen de ganancia).
• No revisar el plazo de desembolso y quedarte sin flujo de caja.
• Guardar las llaves en lugares inseguros.
• No tener plan B: si la pasarela falla, deja un pago manual activo.

Resumen

1. Elige la pasarela según país y medios de pago.
2. Haz el alta como comercio.
3. Conecta con llaves de pruebas y registra la URL de eventos si se pide.
4. Prueba pagos aprobados y rechazados.
5. Pasa a llaves reales y haz una compra real pequeña.
6. Mantén un pago manual de respaldo.

Si buscas una vista de conjunto del tema, mira cobrar en línea con pasarelas de pago y la checklist para lanzar tu tienda en línea.