Skip to main content
Este artículo repasa los cambios realizados en los webhooks salientes de Kajabi como resultado de la introducción de los Order Bumps múltiples. Si tus flujos de trabajo dependen de los webhooks Payment Succeeded o Purchase Created — por ejemplo, a través de una integración con Zapier o una integración personalizada — revisa los cambios a continuación para asegurarte de que tus automatizaciones sigan funcionando como se espera.

​
Cómo se procesan ahora los Order Bumps

Las Ofertas principales de pago único y los Order Bumps de pago único ahora se agrupan en una sola transacción de pago. Esto aplica a todos los checkouts con precios de pago único, incluidas las Ofertas con un solo Order Bump. Antes, cada Oferta de un pedido se cobraba como una transacción separada. Esto representa una mejora importante para los clientes: el precio total se muestra en un solo lugar en el checkout, y se les cobra un único monto. También reduce los costos de procesamiento de pagos, ya que la comisión fija por transacción se aplica una sola vez en lugar de una vez por Oferta. Sin embargo, como las transacciones ahora se estructuran de forma diferente, los webhooks que transportan datos de transacciones u Ofertas han cambiado en consecuencia. Revisa las siguientes secciones para entender qué es diferente.

​
Webhook de Payment Succeeded

El webhook Payment Succeeded se dispara cada vez que se recibe un pago. Con la introducción de los Order Bumps múltiples, las Ofertas principales y los Order Bumps de precio único ahora se combinan en una sola transacción, lo que significa que solo se envía un evento por transacción, sin importar cuántas Ofertas se hayan comprado.

​
Qué cambió

Antes, si un cliente compraba una Oferta principal y un Order Bump, se creaban dos transacciones separadas y se disparaban dos eventos payment_succeeded. Ahora, se crea una sola transacción que cubre todos los artículos de precio único en el pedido, y se dispara un solo payment_succeeded evento. Los detalles de la Oferta — incluyendo el ID de Oferta, el título externo, el título interno y el tipo de precio — contendrán valores separados por comas cuando la transacción incluya más de una Oferta. Esto aplica sin importar si el pedido incluye uno o varios bumps: cualquier checkout en el que se seleccione una Oferta principal de pago único y un bump de pago único ahora producirá una sola transacción y un solo evento Payment Succeeded. Si estás consumiendo este webhook en Zapier o en una integración personalizada y haces referencia a alguno de estos campos de Oferta, ahora recibirás valores separados por comas donde antes recibías un solo valor.
Nota: Esto aplica solo a precios de pago único. Los bumps de suscripción y de plan de pago se cobran como transacciones separadas y siguen disparando su propio Payment Succeeded, sin cambios.

​
Antes (una sola Oferta, una sola transacción)

​
Después (Oferta principal + dos Order Bumps, una sola transacción)

​
Webhook de Purchase Created

El webhook Purchase Created sigue disparando un evento por cada Oferta comprada. Si el pedido de un cliente incluyó la Oferta principal y dos Order Bumps, seguirás viendo tres eventos separados en este webhook, el mismo comportamiento que antes.

​
Qué cambió

Aunque el número de eventos no ha cambiado, los campos de monto de la transacción ahora reflejan el valor total de toda la transacción, no el valor de la Oferta individual de ese evento. Cada evento también incluye un campo de monto a nivel de Oferta que muestra el precio específico de esa Oferta. Si usas este webhook para llevar el registro de ingresos — por ejemplo, sumando amount_paid en todos los registros — debes usar el campo de monto a nivel de Oferta en lugar del monto a nivel de transacción, o estarás contando de más. De nuevo, esto aplica sin importar si el pedido incluye uno o varios bumps: cualquier checkout en el que se seleccione una Oferta principal de pago único y un bump de pago único producirá una sola transacción, y todos los eventos Purchase Created de esa transacción reflejarán el total de la transacción completa en lugar del monto de la Oferta individual.
Nota: Esto aplica solo a precios de pago único. Los bumps de suscripción y de plan de pago se cobran como transacciones separadas y siguen disparando sus propios eventos Purchase Created, sin cambios.

​
Ejemplo

Un cliente compra una Oferta principal de $50 y dos Order Bumps de $20 cada uno. Valor total de la transacción: $90. Recibirás tres eventos purchase. Cada uno se verá así:

​
Evento 1: Oferta principal ($50)

​
Evento 2: Order Bump 1 ($20)

​
Evento 3: Order Bump 2 ($20)

Importante: Los tres eventos comparten el mismo transaction_id y el mismo amount_paid de 9000 ($90.00). Para evitar contar los ingresos de más, usa offer.total_amount / offer.total_amount_decimal — que refleja el precio de la Oferta individual — en lugar de transaction.amount_paid.

​
Endpoint de transacciones de la API

Con los Order Bumps múltiples, una sola transacción ahora puede incluir más de una Oferta. Como resultado, la relación offer en el endpoint de Transacciones ha cambiado.

​
Qué cambió

  • El campo singular offer ya no devolverá datos para transacciones que incluyan Ofertas agrupadas
  • Ahora hay disponible una nueva relación purchases, que devuelve todas las compras de Ofertas asociadas a una transacción
Si usas la API de Kajabi y haces referencia al campo offer en tu integración, revisa el registro de cambios de la API para conocer los detalles de implementación.

​