Cómo integrar Yappy y pagos con tarjeta en tu tienda en línea en Panamá

En Panamá, una tienda en línea que no acepta Yappy pierde ventas. Muchos clientes prefieren pagar desde el celular en segundos antes que escribir los datos de su tarjeta, y otros solo compran si pueden usar tarjeta de crédito. La combinación que mejor convierte para la mayoría de comercios locales es Yappy más tarjeta, con una pasarela internacional como respaldo si vendes fuera del país.

Esta guía explica qué opciones existen, qué necesitas tener listo antes de integrarlas, cómo es el proceso paso a paso y los errores que más vemos cuando un comercio intenta hacerlo por su cuenta. Está escrita para dueños de negocio, no para programadores.

Las opciones para cobrar en línea en Panamá

Qué necesitas antes de empezar

• Una sociedad o aviso de operación vigente y una cuenta bancaria comercial a nombre de la empresa. La mayoría de pasarelas no aprueban cuentas personales para comercio electrónico.
• Un sitio web con dominio propio y certificado SSL (https). Los bancos revisan que la tienda se vea profesional y segura antes de aprobar.
• Políticas publicadas: términos y condiciones, privacidad, devoluciones y envíos. Son requisito habitual en la evaluación del banco y además generan confianza.
• Precios en dólares, descripción clara de cada producto y datos de contacto visibles (teléfono, correo y dirección).
• Acceso a la administración de tu tienda (WordPress, WooCommerce, Shopify o la plataforma a medida) para instalar y configurar la integración.

Cómo integrar Yappy en tu página web

1. Solicita en Banco General el servicio de botón de pago Yappy para comercios. Te pedirán los datos de la empresa y de la cuenta comercial.
2. Una vez aprobado, obtienes las credenciales del comercio para el entorno de pruebas y el de producción.
3. Se instala la integración en tu tienda: en WooCommerce con un plugin compatible y en plataformas a medida con la integración oficial que entrega el banco.
4. Se configura la confirmación automática del pago, para que el pedido pase a "pagado" sin que nadie lo marque a mano y el cliente reciba su correo de confirmación.
5. Se hacen compras de prueba completas: pago aprobado, pago cancelado y pago que el cliente abandona a mitad de camino.
6. Se pasa a producción y se hace una compra real de bajo monto para confirmar que el dinero llega a la cuenta.

El paso que más se olvida es la confirmación automática. Sin ella, el equipo termina revisando la app del banco para saber qué pedidos se pagaron, y los clientes esperan su confirmación horas.

Cómo integrar pagos con tarjeta

Para tarjeta hay dos caminos. El primero es el formulario de pago alojado por la pasarela: el cliente escribe su tarjeta en una página segura del proveedor y vuelve a tu tienda. Es el más simple y el que menos obligaciones de seguridad te deja. El segundo son los campos seguros incrustados, como el Microform de CyberSource: el cliente nunca sale de tu sitio, pero los datos de la tarjeta se capturan en campos del proveedor y llegan a tu servidor solo como un token.

En ambos casos tu servidor nunca debe ver ni guardar el número completo de la tarjeta. Eso reduce de forma importante tus obligaciones de cumplimiento PCI y el riesgo si tu sitio sufre un ataque.

Pasos habituales con CyberSource

1. Tu banco adquirente activa la cuenta de CyberSource y te entrega acceso al entorno de pruebas.
2. Se generan las llaves de API y se guardan como variables de entorno del servidor, nunca dentro del código.
3. Se integra el formulario o los campos seguros, se activa 3D Secure y se configuran reglas antifraude básicas.
4. Se prueban tarjetas aprobadas, rechazadas, con fondos insuficientes y con 3D Secure.
5. El banco revisa la integración y autoriza el paso a producción.

Cuánto tarda y cuánto cuesta

La parte técnica de una integración estándar de Yappy o tarjeta en una tienda que ya existe suele tomar de 1 a 3 semanas. Lo que más alarga el proceso no es la programación sino la aprobación del banco y la entrega de documentos, que puede sumar varias semanas más. Las comisiones por transacción las fija cada banco o proveedor según tu volumen y tipo de negocio, así que conviene pedirlas por escrito antes de elegir.

En Eweb Panamá tenemos un producto con precio publicado para integrar pasarelas en WordPress y cotizamos con precio cerrado las integraciones a medida, como suscripciones, reservas o conciliación con facturación.

Errores comunes que cuestan ventas

• Ofrecer un solo método de pago. Cada método que falta es un grupo de clientes que abandona el carrito.
• Redirigir al cliente a una página de pago que no se ve en el celular o que pide crear una cuenta.
• No confirmar el pago de forma automática y dejar pedidos pagados sin procesar.
• Guardar llaves de la pasarela dentro del código del sitio o compartirlas por correo.
• Saltarse las pruebas de pagos rechazados y cancelados, que es donde aparecen los pedidos duplicados o fantasmas.
• No mostrar en el checkout los logos de los métodos aceptados ni el certificado de seguridad, lo que reduce la confianza.

¿Lo hacemos juntos?

Hemos integrado CyberSource y el botón de Yappy en el sitio de donaciones de Banco de Alimentos Panamá, pagos con tarjeta en la app de Lola Pets y cobros en la plataforma de Gotuuri. Si tu tienda ya existe o la estás por lanzar, cuéntanos qué plataforma usas y qué métodos quieres aceptar, y te enviamos una propuesta con plazo y precio cerrado.