Centro de ayuda · Configuración

Conectar cada pasarela de pago

Qué datos pide Stripe, PayPal, Mercado Pago, Blokko, Pagadito, Culqi y PayU, dónde conseguirlos y qué dirección registrar en su panel.

Actualizado el 30 de septiembre de 2026

Cada pasarela se conecta igual: en Configuración → Métodos de pago, pulsa Configurar en su tarjeta, pega tus datos, pulsa Guardar credenciales y luego Habilitar (ver Cobrar en línea). Al abrir Configurar, la tarjeta te muestra las direcciones de tu sitio que hay que registrar en el panel del proveedor, con un botón para copiarlas: usa esas, porque llevan tu dominio.

Stripe

  • Datos: Publishable key (pk_…) y Secret key (sk_…), en el panel de Stripe → Developers → API keys.
  • Webhook (recomendado): en Developers → Webhooks, agrega la dirección que termina en /api/pagos/stripe/webhook con los eventos de pago (payment_intent.succeeded, payment_intent.payment_failed, payment_intent.canceled y charge.refunded) y pega su Signing secret (whsec_…) en Webhook signing secret. Sin webhook el cobro funciona igual, pero si tu cliente cierra la página justo al pagar, la reserva no se confirma sola.
  • Si su banco pide confirmar la compra (3D Secure), Stripe le muestra ese paso sin salir de tu sitio.
  • Si la tarjeta es rechazada, tu cliente ve el motivo y puede intentar con otra tarjeta en la misma pantalla: se usa la misma reserva, no se crea otra.

PayPal

  • Datos: el Email de tu cuenta PayPal (cuenta de empresa).
  • No hace falta registrar nada: cada pago le dice a PayPal adónde avisar. Si en tu cuenta desactivaste las notificaciones IPN, actívalas con la dirección que termina en /api/pagos/paypal/webhook.
  • Al volver de PayPal, tu cliente puede ver «pendiente» unos segundos: la reserva se confirma cuando PayPal avisa que el pago entró.

Mercado Pago

  • Datos: Access token (APP_USR-… para cobrar de verdad, TEST-… para pruebas), en Tus integraciones → tu aplicación → Credenciales.
  • Webhooks (recomendado): en tu aplicación → Webhooks, agrega la dirección que termina en /api/pagos/mercadopago/webhook con el evento Pagos y copia la clave secreta a Clave secreta de webhooks. Con ella se rechazan avisos que no vengan de Mercado Pago.
  • Horas para pagar en efectivo (OXXO, tiendas) (opcional): cuántas horas se aparta el lugar mientras tu cliente paga su ticket, de 1 a 72. El ticket vence a esa misma hora, así nadie paga un lugar que ya se liberó. Vacío: 30 minutos, como con tarjeta (si alguien paga su ticket después, la reserva se confirma con la marca Sobrecupo si el horario ya se llenó).

Blokko

  • Datos: API key, API secret, Merchant ID y Serial de la terminal que te da Blokko. URL de la API: déjala vacía para pruebas y pon la de producción que te dio Blokko para cobrar de verdad.
  • Moneda de tu cuenta Blokko: la moneda con la que Blokko dio de alta tu comercio (MXN, BRL, COP…). Blokko cobra siempre en esa moneda, así que solo aparece en tu sitio si cobras en ella (ver Monedas y tipo de cambio). Vacía cuenta como MXN.
  • Webhook: la dirección que termina en /api/pagos/blokko/webhook.
  • Tu cliente elige el método (PIX, PSE, NEQUI, cripto…) en una página de tu sitio que muestra el código QR y se actualiza sola al pagar. Si cambia de método se genera otro QR; mientras siga en esa página, pagar cualquiera de los dos confirma la reserva.

Pagadito

  • Datos: UID y WSK, en tu panel de Pagadito → Configuración técnica.
  • URL de retorno (obligatoria): en Configuración técnica → Parámetros de integración, pega la dirección que termina en /api/pagos/pagadito/retorno?token={value} tal cual, con {value}. Si ya tenías configurada la dirección anterior (/api/payment/pagadito/confirm?token={value}), sigue funcionando.
  • Pagadito cobra en USD y en las monedas de Centroamérica.
  • Tu cliente tiene 10 minutos para pagar en la página de Pagadito. Si cancela ahí o se le acaba el tiempo, el pago queda cancelado y la reserva nueva también (puede volver a reservar). En un link de pago, la reserva no se toca y el link sigue activo.

Culqi

  • Datos: Llave pública (pk_…) y Llave secreta (sk_…), en el panel de Culqi → Desarrollo → API Keys.
  • Tu cliente escribe su tarjeta en la ventana segura de Culqi sin salir de tu sitio. Si su banco pide confirmar la compra, Culqi le muestra ese paso.
  • Si la tarjeta es rechazada, tu cliente ve el motivo y puede intentar con otra: la reserva no se cancela.
  • Culqi cobra en soles (PEN) y dólares (USD). Webhook opcional: la dirección que termina en /api/pagos/culqi/webhook.

PayU Latam

  • Datos: Merchant ID, Account ID (el de tu país) y API key, en el panel de PayU → Configuración → Configuración técnica. El API login es opcional.
  • No hace falta registrar nada: cada pago le dice a PayU a qué página regresar y dónde confirmar. Si quieres dejarlas fijas en tu panel de PayU, usa las que terminan en /api/pagos/payu/retorno (página de respuesta) y /api/pagos/payu/webhook (página de confirmación).
  • Tu cliente paga en la página de PayU (tarjeta, PSE, efectivo, según tu país) y vuelve a tu sitio.
  • Horas para pagar en efectivo (OXXO, Efecty, bancos) (opcional): cuántas horas se aparta el lugar mientras tu cliente paga en efectivo, de 1 a 72. El vencimiento del recibo lo pone PayU: si paga después de esas horas y el horario ya se llenó, la reserva se confirma con la marca Sobrecupo. Vacío: 30 minutos.

Preguntas frecuentes

Cambié de dominio. ¿Tengo que actualizar algo? Sí: las direcciones que registraste en Stripe, Mercado Pago, Blokko y Pagadito llevan tu dominio. Abre Configurar en cada una, copia las nuevas y cámbialas en el panel del proveedor.

Mi cliente pagó pero la reserva sigue pendiente. Revisa que la dirección del webhook (o la URL de retorno en Pagadito) esté registrada en el panel del proveedor. En PayPal espera unos minutos: a veces su aviso tarda.

¿Qué pasa si la misma notificación llega dos veces? Nada: el pago se confirma una sola vez y tu cliente recibe un solo correo.

¿Te quedó alguna duda? Escríbenos por WhatsApp.