Saltar al contenido

Integración de CyberSource Unified Checkout

Dejamos tu web cobrando con tarjeta de crédito y débito de verdad: firma en el servidor, autenticación 3-D Secure 2 y confirmación por webhook, para que ninguna orden se pierda porque alguien cerró la ventana.

Precio
desde $1,050 por integración (alcance Esencial)
Plazo
De 5 a 7 días hábiles (Esencial) a 18 a 25 días hábiles (Avanzado)
  • Las comisiones por transacción las cobra CyberSource o tu banco adquirente, aparte de estos honorarios.
  • Precios en dólares, sin ITBMS (7%).
Tarjeta bancaria lisa con un escudo protector delante, en cromo plateado, render 3D sobre fondo gris claro
Una integración de pagos mal hecha no falla con un error visible: falla cobrando de menos, registrando de más o dejando que alguien cambie el precio.

Elemento Web, desde Ciudad de Panamá, integra CyberSource Unified Checkout en tu web para cobrar con tarjeta de crédito y débito: firma HMAC en el servidor, 3-D Secure 2 y confirmación por webhook. Tres alcances con precio cerrado: $1,050, $2,150 y $3,850, sin ITBMS. Tu servidor nunca toca la tarjeta, así que tu cumplimiento queda en PCI-DSS SAQ A.

Actualizado el 13/10

Resultados de clientes

Resultado medido: sin publicar aún, falta la autorización del cliente

Qué es CyberSource y qué es Unified Checkout

CyberSource es la pasarela de pagos de Visa. Es la plataforma que varios bancos adquirentes le ofrecen a sus comercios para procesar tarjetas de crédito y débito. Si tu banco en Panamá te habló de CyberSource al aprobarte la cuenta de comercio, esta es la integración que te toca.

Unified Checkout es su formulario de pago embebido. Los campos donde tu cliente escribe la tarjeta se ven dentro de tu página, pero los sirve CyberSource: el número viaja directo a ellos y tu servidor nunca lo toca. Tu cliente no sale de tu web y tú no cargas con el riesgo de guardar tarjetas.

Cliente escribe su tarjeta en un formulario seguro dentro de la web desde la mesa de su casa, sin salir del sitio

Lo que resuelve en tu web

  • Tarjetas de verdadCrédito y débito, locales y del exterior. Es lo que te falta si hoy solo puedes cobrar por transferencia o por Yappy y estás perdiendo al cliente que paga con tarjeta.
  • Sin cargar con los datosLos campos de tarjeta los aloja CyberSource. Tu servidor no ve ni guarda el número, así que tu cumplimiento PCI-DSS se queda en el cuestionario más simple, el SAQ A.
  • Ninguna orden perdidaEl webhook confirma cada cobro servidor a servidor. Si tu cliente cierra la pestaña justo después de pagar, la orden se registra igual. Es el error silencioso más común de estas integraciones.

Tres alcances, precio cerrado

La diferencia entre uno y otro no es de calidad: es cuánto tiene que hacer tu sistema solo después del cobro. Elige por volumen de operaciones, no por presupuesto.

Esencial

Cobros inmediatos en los que el cliente paga y ve el resultado en la misma pantalla. Sin estados diferidos ni sincronización con otros sistemas.

desde$1,050pago único
  • Generación del capture context y las llaves de un solo uso en tu servidor.
  • Firma de cada petición con HMAC-SHA256, para que nadie pueda alterar el monto.
  • Checkout embebido en tu página de cobro, con los campos de tarjeta alojados por CyberSource.
  • Pantallas de pago aprobado y pago rechazado, con el mensaje que corresponde a cada caso.
  • Pruebas completas en el ambiente de sandbox antes de tocar producción.
  • Entrega en 5 a 7 días hábiles y 15 días de soporte tras el lanzamiento.
Cotizar el alcance Esencial
Recomendado

Profesional

Tiendas y portales donde perder una orden cuesta dinero. El servidor confirma cada pago por su cuenta, aunque el cliente cierre la ventana antes de volver.

desde$2,150pago único
  • Todo lo del alcance Esencial.
  • Webhook verificado: tu servidor recibe la confirmación de CyberSource y actualiza la orden solo, sin depender del navegador.
  • Registro en base de datos: identificador de transacción, código de autorización, monto y estado, para que puedas auditar y conciliar.
  • 3-D Secure 2 configurado: la autenticación del banco emisor, que traslada la responsabilidad del contracargo por fraude al emisor cuando se aprueba.
  • Manejo de los casos que casi nadie prueba: pago duplicado, timeout y reintento.
  • Acompañamiento en el paso a producción y en el primer cobro real.
  • Entrega en 10 a 14 días hábiles y 30 días de soporte tras el lanzamiento.
Cotizar el alcance Profesional

Avanzado

Empresas con volumen, donde alguien de administración necesita resolver reembolsos y consultar cobros sin entrar al portal de CyberSource ni pedirle nada a un programador.

desde$3,850pago único
  • Todo lo del alcance Profesional.
  • Reembolsos y anulaciones totales o parciales desde tu propio panel, con registro de quién los hizo.
  • Tarjetas guardadas: tokenización del cliente para cobros de un clic y suscripciones, sin que la tarjeta pase nunca por tu base de datos.
  • Conexión con tu ERP o CRM: el cobro dispara el recibo, la factura o la tarjeta en el sistema que ya usas.
  • Panel de conciliación: lo cobrado en CyberSource contra lo registrado en tu sistema.
  • Documentación técnica: diagramas del flujo y manual de mantenimiento, para que no dependas de nosotros.
  • Entrega en 18 a 25 días hábiles desde recibir el contenido y aprobar el alcance, y 60 días de soporte prioritario.
Cotizar el alcance Avanzado

Precios en dólares, no incluyen ITBMS (7%). El pago va en tres partes, igual que el resto de nuestros proyectos: 50% para arrancar, 30% al aprobar la demostración en sandbox y 20% al pasar a producción. Las comisiones por transacción las cobra CyberSource o tu banco adquirente y son independientes de estos honorarios.

Qué entra en cada alcance

La misma información de arriba, tarea por tarea, para que la puedas comparar sin volver a subir.

Qué entra en cada alcance
Tarea técnicaEsencial · $1,050Profesional · $2,150Avanzado · $3,850
Firma criptográfica HMAC-SHA256 en el servidorSíSíSí
Checkout embebido con el SDK de Unified CheckoutSíSíSí
Respuesta capturada en el navegador (síncrona)SíSíSí
Webhook verificado en el servidor (confirmación asíncrona)—SíSí
Orden, código de autorización e ID de transacción en base de datos—SíSí
3-D Secure 2 (EMV 3DS)BásicoCompletoCompleto
Reembolsos y anulaciones sin entrar al portal de CyberSource——Sí
Tarjetas guardadas y cobros recurrentes——Sí
Conexión con ERP, CRM o sistema contable——Sí
Soporte tras salir a producción15 días30 días60 días

«—» significa que la tarea no entra en ese alcance.

Así se vería el cobro en tu web

Lo que ve tu cliente al pagar, lo que hace su banco y lo que ves tú al final del día. El monto se firma en tu servidor, nunca en el navegador.

Ejemplo de resumen de pago en la tienda Tu tienda

Tu tienda · Resumen de tu pedido

Tour en lancha · 2 personas
$180.00
Subtotal, ITBMS incluido
$180.00

Entrega

  • Entrega digitalConfirmación por correo al instanteGratis

Forma de pago

  • Tarjeta de crédito o débito
  • Yappy

Total$180.00

Pagar $180.00 con tarjeta
Ejemplo de pantalla de edición del panel: Confirma tu compra en Tu tienda

Confirma tu compra en Tu tienda

Monto
$180.00
Tarjeta
Terminada en 4417
Código enviado a
Tu celular terminado en 47
Código de verificación
• • • • • •
Confirmar pago
Cobros con tarjeta de hoyTu tienda · ejemplo
  • Cobros aprobados42(bien)
  • Rechazados por el banco emisor3(revisar)
  • Órdenes confirmadas por webhook42 de 42(bien)
  • Cobros sin orden u órdenes sin cobro0(bien)
  • Reembolsos hechos desde tu panel1(bien)

La conciliación compara lo cobrado en CyberSource con lo registrado en tu sistema (alcance Avanzado).

Ejemplo de conversación de WhatsApp con Tu tienda

Tu tiendaCuenta de empresa

Hola, pagué el tour pero se me cerró la página antes de ver la confirmación. ¿Quedó?

15:20

Sí, quedó: tu pago de $180.00 está confirmado y la reserva para el sábado está registrada. Te reenviamos la confirmación por correo.

15:21
Qué pasa en un cobro, paso a paso
  1. Tu servidor firmaGenera el capture context y firma el monto con HMAC-SHA256: nadie lo cambia desde el navegador.
  2. El cliente pagaEscribe la tarjeta en campos que sirve CyberSource dentro de tu página.
  3. 3-D SecureSu banco lo verifica; muchas veces sin pedirle nada.
  4. RespuestaVe en pantalla si el pago fue aprobado o rechazado.
  5. WebhookCyberSource confirma a tu servidor y la orden se registra aunque haya cerrado la ventana.

Tienda, montos, tarjeta y cifras de ejemplo. Los campos de tarjeta los sirve CyberSource: tu servidor nunca ve el número.

Dónde está el riesgo y cómo se cierra

Una integración de pagos mal hecha no falla con un error visible. Falla cobrando de menos, registrando de más, o dejando abierta la puerta para que alguien cambie el precio desde el navegador.

  • Alcance PCI-DSS: SAQ ACon el checkout embebido, el número de tarjeta, la fecha y el código de seguridad los captura CyberSource en campos que ellos controlan. Tu servidor nunca los recibe. Eso te deja en el cuestionario de autoevaluación más corto, el SAQ A, en lugar de la certificación completa que exige guardar datos de tarjeta. Es una diferencia de miles de dólares al año en auditoría.
  • Firma en el servidor, no en el navegadorCada petición a la API se firma con HMAC-SHA256 usando la llave secreta del comercio, y esa llave vive solo en el servidor. Sin esto, cualquiera con las herramientas de desarrollo del navegador puede cambiar el monto, la moneda o el número de pedido antes de enviarlo. Es el fallo que más veces encontramos al revisar integraciones hechas a la carrera.

Qué recorre un pago con tarjeta en tu web

Tu cliente paga en tu página, pero los campos de la tarjeta los sirve Unified Checkout, el formulario seguro de CyberSource. El número de tarjeta nunca pasa por tu web ni por tu servidor, y por eso tu cumplimiento queda en PCI-DSS SAQ A.

Antes de aprobar, el banco emisor confirma que quien paga es el titular con 3-D Secure 2. Muchas veces lo hace sin pedirle nada; otras, con un código al celular.

Con el pago aprobado, CyberSource avisa a tu servidor por webhook y la orden se confirma sola, aunque el cliente haya cerrado la pestaña. El webhook entra desde el alcance Profesional.

Cómo se cobra con tarjeta usando CyberSource El cliente paga en el formulario seguro Unified Checkout de CyberSource, su banco lo autentica con 3-D Secure 2, el pago se aprueba y un webhook avisa a tu servidor para confirmar la orden aunque el cliente cierre la pestaña; la tarjeta nunca pasa por tu web. Tu cliente paga Unified Checkout formulario de CyberSource 3-D Secure 2 el banco confirma al titular Pago aprobado Webhook a tu servidor la orden se confirma sola la tarjeta no pasa por tu web
Simplificado: antes de todo esto, tu servidor firma el monto con HMAC-SHA256 para que nadie lo cambie desde el navegador.

Cómo se ejecuta, día por día

El cronograma del alcance Profesional. Los otros dos se acortan o se alargan sobre esta misma secuencia, y en todos los casos apruebas en sandbox antes de que se toque producción.

  1. 01 · Credenciales y ambiente (días 1 y 2)

    Recibimos tu merchant ID y las llaves de sandbox, y montamos las variables de entorno donde deben estar: en el servidor, nunca en el código del navegador.

  2. 02 · Servidor y seguridad (días 3 a 6)

    La firma HMAC, la generación del capture context y el endpoint que recibe y verifica los webhooks de CyberSource.

  3. 03 · Checkout y pruebas (días 7 a 9)

    El checkout embebido en tu página de cobro, las pantallas de respuesta y la batería de tarjetas de prueba, incluidas las que deben fallar.

  4. 04 · Paso a producción (días 10 a 12)

    Cambio a credenciales reales, primer cobro de verdad con monto mínimo, y te entregamos accesos y guía de operación.

Cómo se pierde una orden sin webhook

Sin webhook, tu web se entera del pago solo por el navegador: el cliente paga, CyberSource responde y la página de confirmación registra la orden. Mientras todo va bien, no se nota la diferencia.

El problema aparece cuando esa respuesta no llega: el cliente cierra la pestaña, pierde la señal o deja el celular justo después de pagar. El cobro queda hecho en CyberSource y la orden no existe en tu sistema.

Ahí empieza el trabajo manual: el cliente escribe preguntando si quedó, alguien busca el cobro en el portal y registra la orden a mano. El webhook evita ese paso porque la confirmación va de servidor a servidor, sin depender del navegador.

El dueño de una tienda en línea en Panamá revisa sus pedidos en la laptop mientras atiende un mensaje en el celular.

Qué te pide el banco y qué te pedimos nosotros

La integración empieza cuando tu banco adquirente ya aprobó tu cuenta de comercio. Ese trámite lo lleva el banco, no nosotros, y va primero.

Con la cuenta aprobada, recibes el merchant ID y las llaves de sandbox y de producción. Esas llaves viven en el servidor, nunca en el código del navegador, y con ellas se firma cada petición.

De tu lado necesitamos además acceso al servidor o al repositorio del sitio. Antes de cotizar hacemos una revisión técnica sin costo: si tu sitio no da para hacerlo bien, te lo decimos antes de facturarte.

Una empresaria panameña conversa con un ejecutivo en la oficina de un banco en Ciudad de Panamá.

Condiciones y qué necesitamos de ti

CyberSource es una marca registrada de Visa Inc. No somos distribuidores ni representantes de CyberSource: integramos su API en tu sitio.

  • Forma de pago50% para arrancar, 30% al aprobar la demostración en sandbox y 20% al pasar a producción. Los precios no incluyen ITBMS (7%).
  • Lo que aportasTu cuenta de comercio aprobada por el banco, el merchant ID con llaves de sandbox y producción, y acceso al servidor o repositorio del sitio.
  • Garantía30 días por fallas técnicas en todos los alcances, más el período de soporte de cada uno: 15, 30 o 60 días.
  • Revisión técnica sin costoAntes de cotizar revisamos tu sitio. Si no da para hacerlo bien, te lo decimos antes de facturarte, no a mitad del proyecto.

Entregables

  • Integración funcionando en producción, con el primer cobro real
  • Pruebas en sandbox que apruebas antes de producción
  • Accesos y guía de operación
  • Diagramas del flujo y manual de mantenimiento (alcance Avanzado)

No incluye

  • Las comisiones por transacción de CyberSource y de tu banco adquirente
  • El trámite de la cuenta de comercio, que lo lleva el banco

Cómo lo medimos

  • Cobros aprobados y rechazados
  • Órdenes confirmadas por webhook
  • Diferencias de conciliación
  • Pagos duplicados y reintentos

Por qué con nosotros

Preguntas que puedes hacerle a cualquier proveedor antes de dejarle tu pasarela de pagos. Usa la última columna para comparar.

Por qué con nosotros
CriterioElemento WebTu otra cotización
PrecioCerrado y publicado: $1,050, $2,150 o $3,850espacio para completar
Firma de cada peticiónHMAC-SHA256 en el servidor; la llave nunca llega al navegadorespacio para completar
Datos de tarjetaNunca pasan por tu servidor: PCI-DSS SAQ Aespacio para completar
Órdenes perdidasWebhook verificado desde el alcance Profesionalespacio para completar
PruebasEn sandbox, con las tarjetas que deben fallar, antes de producciónespacio para completar
Casos bordePago duplicado, timeout y reintento, desde el alcance Profesionalespacio para completar
Soporte tras el lanzamiento15, 30 o 60 días según el alcanceespacio para completar

Preguntas frecuentes

¿Qué es CyberSource y en qué se diferencia de Yappy?

CyberSource es la pasarela de pagos de Visa: procesa tarjetas de crédito y débito y es la que varios bancos adquirentes ofrecen a sus comercios. Yappy es un botón de pago local que mueve dinero entre cuentas panameñas. No compiten, se complementan: lo habitual en una tienda en Panamá es tener los dos, Yappy para quien paga desde su banco y tarjeta para quien paga con crédito o desde el exterior.

¿Cuánto cuesta integrar CyberSource en mi web?

Desde $1,050 para el cobro directo, $2,150 para la versión con webhooks y base de datos, que es la que recomendamos para una tienda, y $3,850 cuando además necesitas reembolsos desde tu panel y tarjetas guardadas. Precio cerrado por escrito antes de arrancar, en dólares y sin incluir ITBMS (7%). Las comisiones por transacción las cobra CyberSource o tu banco y van aparte de nuestros honorarios.

¿Qué necesito tener antes de que empecemos?

Tres cosas: la cuenta de comercio ya aprobada con tu banco adquirente, el merchant ID con sus llaves de sandbox y producción, y acceso al servidor o repositorio de tu sitio. Si todavía no tienes la cuenta de comercio, ese trámite va primero y lo lleva el banco, no nosotros. Podemos ayudarte a entender qué te van a pedir.

¿Mi servidor va a guardar números de tarjeta?

No, y ese es el punto del checkout embebido. Los campos donde se escribe el número, la fecha y el código de seguridad los sirve CyberSource dentro de tu página: los datos viajan directo a ellos y tu servidor nunca los ve ni los almacena. Eso mantiene tu cumplimiento PCI-DSS en el cuestionario más simple, el SAQ A, en vez de obligarte a la certificación completa.

¿Por qué hace falta un webhook si el navegador ya me dice si el pago pasó?

Porque el navegador se puede cerrar. Si el cliente paga y cierra la pestaña antes de volver a tu sitio, la respuesta síncrona nunca llega y tú tienes un cobro en CyberSource sin orden registrada. El webhook lo manda el servidor de CyberSource al tuyo, así que la orden se actualiza igual. Es la diferencia principal entre el alcance Esencial y el Profesional, y es la razón por la que para una tienda recomendamos el segundo.

¿Qué es 3-D Secure y me conviene activarlo?

Es la verificación que hace el banco que emitió la tarjeta, normalmente un código al celular del cliente. Suma un paso al pago, y en cambio traslada al emisor la responsabilidad del contracargo por fraude cuando la autenticación se aprueba. Con la versión 2 ese paso muchas veces es invisible, porque el banco decide no pedir nada si la operación le parece de bajo riesgo. Para vender en línea en Panamá, sí conviene.

¿Cuándo NO conviene esta integración?

Cuatro casos. Si tu banco no te ofreció CyberSource, hay que integrar la pasarela que sí te dio. Si tu volumen es bajo y el ticket alto, cobrar por Yappy o transferencia te sale gratis y funciona. Si tu tienda es Shopify o WooCommerce y existe un módulo oficial de tu pasarela, ese módulo puede alcanzarte sin desarrollo a medida. Y si todavía no tienes cuenta de comercio, primero el banco. Te lo decimos antes de cotizar, no después.

¿Funciona sobre la web que ya tengo?

Sí, siempre que tenga un servidor donde podamos correr la firma y recibir los webhooks. Trabajamos sobre WordPress, WooCommerce, desarrollos en Vue o React y sitios a medida. Lo primero es una revisión técnica sin costo: si tu sitio actual no da para hacerlo bien, te lo decimos antes de facturarte, no a mitad del proyecto.

¿Cuánto tarda la integración?

De 5 a 7 días hábiles en el alcance Esencial, de 10 a 14 en el Profesional y de 18 a 25 en el Avanzado. En todos apruebas la demostración en sandbox antes de pasar a producción.

¿Cómo se paga la integración?

En tres partes: 50% para arrancar, 30% al aprobar la demostración en sandbox y 20% al pasar a producción. Los precios no incluyen ITBMS (7%).

¿Qué pasa si algo falla después del lanzamiento?

Todos los alcances tienen 30 días de garantía por fallas técnicas, más el período de soporte de cada uno: 15 días en Esencial, 30 en Profesional y 60, prioritario, en Avanzado.

Cotiza la integración

Cuéntanos qué plataforma tiene tu sitio y qué te pidió el banco. Te decimos qué alcance necesitas y qué va a costar, por escrito y antes de arrancar. La revisión técnica no tiene costo.

Te contactamos el mismo día hábil para aclarar tu necesidad. Después recibes una propuesta con alcance, plazo y precio.

Los campos con asterisco son obligatorios. Tus datos solo se usan para responderte.