Guía del usuario de Webhooks

Introducción

Este documento se proporciona como recurso técnico para los comerciantes de CCBill. Analiza las características y la implementación del sistema CCBill Webhooks. Este documento está destinado a ser leído por programadores, técnicos y otras personas con habilidades de codificación avanzadas.

Los usuarios de esta guía deben tener conocimientos de programación suficientes para permitir que sus propios sistemas recuperen los datos enviados a las URL que ha configurado para la inserción de datos de Webhooks. Esta guía busca brindarle la funcionalidad para pasar los datos del consumidor al formulario de pago de CCBill, así como las variables enviadas y los parámetros potenciales de esas variables para todos los eventos transaccionales en una cuenta.

Formato codificado

En julio de 2017, la posibilidad de elegir entre dos formatos diferentes de los datos de Webhook. El formato original se conoce como "URL codificada" y utiliza el tipo de contenido application / x-www-form-encoded. El formato más nuevo se conoce como "JSON" y formatea los datos para que sigan el formato de archivo estándar abierto JSON (JavaScript Object Notation) y utiliza el tipo de contenido application / json.

Versiones

En octubre de 2013, agregamos soporte en Webhooks para diferentes versiones. Esto asegura que cualquier cambio en el sistema de Webhooks no romperá su configuración existente.

Si un Webhook tiene más de una versión, mostrará contenido con pestañas. Haga clic en la pestaña de la versión que está utilizando para ver los detalles de esa llamada.

En abril de 2017, agregamos soporte para el protocolo de cifrado TLS 1.2.

En mayo y junio de 2017, incluimos parámetros adicionales para múltiples eventos.

En julio de 2017, incluimos soporte para seleccionar números de versión de configuración específicos para cada tipo de evento de URL de Webhook. Esto permite a los usuarios seleccionar versiones anteriores o actualizar a la versión más reciente a través de un menú desplegable que muestra todos los números de versión disponibles. También se incluyó con esta actualización la capacidad de seleccionar los datos de webhook con formato JSON. Los formatos admitidos se enumeran dentro de cada versión enumerada en las secciones siguientes.

El ChangeLog al final de este documento resumirá los cambios realizados para cada versión.

Pasar variables al formulario de pago

Las variables se pueden pasar al formulario de pago para completar previamente la información del consumidor. Esto se puede implementar con el propósito de formularios de varias partes, seguimiento personalizado y otras implementaciones. Las variables se pasan al formulario de pago desde la página que lo precede mediante el uso de un formulario HTML o pasando las variables a través de la cadena URL. A continuación se ofrecen ejemplos de código.

Las variables de seguimiento personalizadas también se pueden enviar al formulario. Estos valores se volverán a publicar en la URL de Webhooks cuando se complete la transacción. Para definir estas variables, simplemente especifique un nombre de variable y un valor de la misma manera que las otras variables que se pasan.

Las variables de seguimiento personalizadas opcionales se pueden agregar manualmente creando campos de formulario HTML adicionales o pasando las variables adicionales a la cadena de URL, según el método de envío elegido.

El siguiente ejemplo muestra el código de botón HTML básico, con dos variables personalizadas agregadas. El botón creado, cuando se haga clic, llevará al consumidor al formulario de pago CCBill mientras pasa las dos variables personalizadas:

<form action='https://bill.ccbill.com/jpost/signup.cgi' method=POST>
<input type=hidden name=clientAccnum value='900000'>
<input type=hidden name=clientSubacc value='0001'>
<input type=hidden name=formName value='211cc'>
<input type=hidden name=language value='English'>
<input type=hidden name=allowedTypes value='0000003361:840,0000004657:840,0000060748:840,0000060750:840,0000060752:840'> <input type=hidden name=subscriptionTypeId value='0000004657:840'>
<input type=hidden name=customVarName1 value=customVarValue1>
<input type=hidden name=customVarName2 value=customVarValue2>
<input type=submit name=submit value='Join Now'>
</form>

Tenga en cuenta que customVarName1 y customVarName2 son solo ejemplos de nombres y pueden ser cualquier cosa que elija. Los valores también pueden ser los que elija.

Puede utilizar un enlace de texto en lugar de un botón si lo desea. El siguiente ejemplo muestra cómo hacer esto usando datos idénticos a los del ejemplo de formulario anterior:

https://bill.ccbill.com/jpost/signup.cgi?clientAccnum=900000&clientSubacc=0001&formName=211cc&language=English&allowedTypes=0000003761:840,0000004607:840,0000060248:840,0000063750:840,0000060752:840&subscriptionTypeId=0000004657:840&customVarName1=customVarValue1&customVarName2=customVarValue2

Ambos métodos tienen el mismo propósito y se pueden utilizar.

La información también se puede pasar al formulario de pago CCBill utilizando variables dinámicas en un script personalizado. Un formulario HTML personalizado puede llamar al script, que luego envía las variables al formulario de pago CCBill.

El formulario que cree pasará los datos ingresados ​​por el consumidor al siguiente formulario, que luego pasará las variables al formulario de pago CCBill. Una vez completada la transacción, los datos se enviarán a la URL de Webhooks.
El siguiente ejemplo de código usa código Perl / CGI para generar un campo de formulario HTML oculto usando una variable dinámica:

impresión " ";

Otros lenguajes tendrán diferentes declaraciones y sintaxis para la salida de datos, como declaraciones de impresión o eco en PHP. El código de enlace se puede generar de manera similar al código de formulario HTML anterior, reemplazando cualquier número de valores de variables estáticas con variables dinámicas.

Consulte cualquier pregunta que tenga acerca de este tipo de código a un programador calificado.

Recibiendo información

Cuando se aprueba o deniega una transacción, los datos se enviarán a la URL de Webhooks, si ese evento se ha seleccionado dentro de la configuración. Los datos enviados incluirán todo lo pasado en el formulario de pago junto con los datos ingresados ​​en el formulario de pago por el consumidor, excluyendo la información de pago. Estos datos se pueden analizar y manejar de cualquier forma que se codifique el script.

Los datos se pueden capturar de varias formas según el idioma en el que esté escrito el script de Webhooks. Por ejemplo:

Usando PHP

La siguiente línea captura el nombre del consumidor y lo asigna a una variable llamada $ fname. La variable $ fname se puede nombrar como quieras.

$fname = $_POST["customer_fname"]

Usando Perl / CGI

La siguiente línea captura el nombre del consumidor y lo asigna a una variable llamada $ fname. La variable $ fname se puede nombrar como quieras.

$fname = param("customer_fname")__

Otros lenguajes tendrán funciones apropiadas para capturar datos POST. Tenga en cuenta que los nombres de las variables deben ingresarse exactamente como aparecen en este documento.

Una vez que la secuencia de comandos captura estos valores variables, la secuencia de comandos puede manejar los datos de cualquier manera especificada en la secuencia de comandos, como ingresar la información en una base de datos.

Variables

CCBill tiene un conjunto de variables de sistema especificadas que se pueden utilizar para extraer datos del sistema de CCBill. Se utilizan dos conjuntos de variables, uno para cada una de las siguientes situaciones:

• Formulario de pago. Estas variables se utilizan para rellenar previamente el formulario de pago. Nombrar las variables correctamente, como se enumera a continuación, garantizará que los datos se almacenen correctamente en el sistema de CCBill como se pretende con las variables.
• Ida y vuelta. Estas variables se envían a la URL del webhook, según el resultado de la transacción.

En ambos casos, las variables personalizadas se enviarán exactamente como se ingresaron.

Los nombres de las variables del sistema deben ingresarse exactamente como aparecen en esta lista.

Formulario de pago

El siguiente cuadro enumera cada variable que se puede completar previamente en el formulario de pago:

Nombre de la variable	Descripción
nombre_cliente	Nombre del consumidor
nombre_cliente	Apellido del consumidor
address1	Dirección del consumidor
email	Dirección de correo electrónico del consumidor
ciudad	Ciudad consumidora
estado	Estado del consumidor
código postal	Código postal del consumidor
país	País consumidor
número de teléfono	Número de teléfono del consumidor
nombre de usuario	Nombre de usuario del consumidor
la contraseña	Contraseña de consumidor
LifeTimeSubscription

Las siguientes variables también se pueden pasar al formulario de pago, pero no se muestran en el formulario:

Nombre de la variable	Descripción	Valor de ejemplo
árbitro	Número de identificación de afiliado de CCBill. Este valor se pasa como 'revendedor' cuando se usa Traffic Manager para pasar en cascada a los formularios de Epoch.	1626321
nombre del formulario	Tres o más códigos de caracteres que identifican el formulario.	13cc
confirmar Contraseña	Confirme la contraseña en el formulario de registro.	0 o 1 (sí o no)
suscripciónTypeId	ID de tipo de suscripción.	0108191202000001259
tipos permitidos	Las opciones de suscripción que aparecerán en el formulario; este valor se genera automáticamente en el Admin.	0000003761:840,0000004607:840

Habilitación de webhooks en el portal de administración

1. Inicia sesión en el Portal de administración.
2. Haz clic en el botón Info de Cuenta Mega Menú, luego seleccione Administrador de subcuenta en la sección Administrar subcuentas del menú.
3. Haz clic en el botón Webhooks enlace en el lado izquierdo de la pantalla.
4. Ingrese la URL a la que desea que se dirijan las publicaciones en el URL del webhook campo.
5. Seleccione los tipos de publicaciones a las que desea suscribirse (haga clic en Todo para seleccionar todos los tipos, o seleccionar y elegir cualquier combinación de tipos de publicaciones seleccionando la casilla de verificación junto a ella).
6. Seleccionando el Ubicaciones satélite desde el que los Webhooks deberían enviarte mensajes. Elegir una ubicación que esté geográficamente cerca del host de la URL que seleccionó en el paso 2 garantiza que las publicaciones lleguen a su URL rápidamente y brinde el tiempo de respuesta más rápido de nuestro sistema, aunque seleccionar las 3 ubicaciones proporcionará el nivel más alto de redundancia. Las ubicaciones de los satélites son actualmente Phoenix, AZ, Ashburn, VAy Amsterdam, Países Bajos.
7. Haga clic en Actualizar para guardar la configuración.

Después de que se haya guardado al menos un Webhook, se le presentará la opción de editar, eliminar o agregar más. Puede agregar hasta 4 Webhooks, y cada uno puede usar URL diferentes si lo desea.

Cambio de versiones de Webhooks

Siempre que cree una nueva configuración, creará una configuración que coincida con la versión más actual de Webhooks. Si tiene una configuración que ya se creó con una versión anterior de Webhooks, se le dará la opción de actualizar la configuración.

Actualizar un Webhook existente para cambiar la URL NO actualizará una configuración existente a una nueva versión.

Agregar un nuevo evento a una configuración de Webhooks existente creada en una versión anterior de Webhooks dará como resultado que el evento recién agregado tenga la versión actual de ese evento, mientras que todos los eventos que estaban en la configuración continuarán usando la versión anterior del evento. .

Rangos de IP de Webhooks

Recibirá Webhooks de los siguientes rangos de IP de CCBill:

• 64.38.212.1 - 64.38.212.254
• 64.38.215.1 - 64.38.215.254
• 64.38.240.1 - 64.38.240.254
• 64.38.241.1 - 64.38.241.254

Puede usar esta información para configurar reglas de firewall o confirmar la validez de un Webhook desde su aplicación.

Parámetros de URL

Webhooks envía 4 parámetros de URL con publicaciones que están destinadas a hacerle saber qué tipo de Webhook contiene la publicación. Se envían los siguientes parámetros:

clienteAccnum	Número de cuenta del comerciante.
clienteSubacc	El número de subcuenta del comerciante.
tipo de evento	El evento de Webhook que se envía, como NewSaleSuccess o Expiration
tipo de grupo de eventos	El grupo de eventos al que pertenece el tipo de evento. En este momento, solo la suscripción es una opción válida.

Los parámetros de URL constituyen la primera línea en el siguiente ejemplo de publicación de Webhooks.

Ejemplo de publicación de webhooks

Formato codificado de URL

POST /webhooks.php?clientAccnum=999999&clientSubacc=9999&eventType=Expiration&eventGroupType=Subscription HTTP/1.1
X-Allowed-Satellites: PHX,ASH,AMS
Content-Type: application/x-www-form-urlencoded
Content-Length: 102
Host: merchanturl.com
User-Agent: Java/1.6.0_03
Via: 1.1 wmq1.ccbill.com:3129 (squid/2.7.STABLE5), 1.0 internal
Cache-Control: max-age=0
Connection: keep-alive

clientAccnum=999999&clientSubacc=9999&subscriptionId=0913024401000012340&timestamp=2013-01-25 03:22:44

Formato JSON

POST /webhooks.php?clientAccnum=999999&clientSubacc=9999&eventType=Expiration&eventGroupType=Subscription HTTP/1.1
X-Allowed-Satellites: PHX,ASH,AMS
Content-Type: application/json
Content-Length: 102
Host: merchanturl.com
User-Agent: Java/1.6.0_03
Via: 1.1 wmq1.ccbill.com:3129 (squid/2.7.STABLE5), 1.0 internal
Cache-Control: max-age=0
Connection: keep-alive
{"clientAccnum":"999999","clientSubacc":"9999","subscriptionId":"0913024401000012340","timestamp":"2013-01-25 03:22:44"}

Notificaciones de webhooks

Las siguientes secciones detallan las notificaciones que los Webhooks pueden enviar a su URL y enumeran las variables que se incluyen en el envío de notificaciones. La información incluida en cada tipo de notificación se incluye en la última línea del ejemplo de publicación de Webhooks anterior.

En el ejemplo anterior, el Webhook que se envía es para el Webhook de vencimiento. Para cada Webhook diferente enviado, la información enviada será diferente (según el tipo de evento parámetro en la primera línea), pero el formato será el mismo.

UsuarioReactivación

formatos compatibles: URL codificada, JSON

Nombre de la variable	Descripción	Tipo de datos (Longitud máxima)	Valor de ejemplo
ID de suscripción	Número de identificación de suscripción.	bigint (20) sin firmar	1000000000
ID de transacción	Número de identificación de la transacción.	cadena	0912191101000000159
Precio	Precio del producto (como se muestra en el formulario).	cadena	5.95 por 30 días (no recurrente)
nombre de usuario	Nombre de usuario del consumidor.	varchar (16)	username1
la contraseña	Contraseña de consumidor.	varchar (30)	micontraseña
clienteAccnum	Número de cuenta principal de CCBill Merchant.	mediano (6) no firmado	900100
clienteSubacc	Número de subcuenta del comerciante de CCBill.	smallint (4) no firmado cerofill	0000
email	Dirección de correo electrónico del consumidor.	varchar (40)	usuario@randomurl.com
siguienteFecha de renovación	Próxima fecha de facturación para suscripciones recurrentes.	cadena	2021-08-20

NuevaVentaÉxito

Algunos campos, como avsRespuesta y cvv2Respuesta, no se enviará si las funciones asociadas no han sido configuradas por Merchant Support.

Este evento tiene más de una versión. Haga clic en la pestaña de la versión que desea ver.

NuevaVentaFracaso

Algunos campos, como avsRespuesta y cvv2Respuesta, no se enviará si las funciones asociadas no han sido configuradas por Merchant Support.

ActualizarÉxito

Igual que NuevaVentaÉxito pero con estos parámetros adicionales agregados. NewSaleSuccess tiene varias versiones; tenga cuidado de usar la versión apropiada de ese Webhook cuando codifique para este Webhook.

Error de actualización

Lo mismo que NewSaleFailure pero con estos parámetros adicionales agregados.

formatos compatibles: URL codificada, JSON

Nombre de la variable	Descripción	Tipo de datos (longitud máxima)	Valor de ejemplo
ID de suscripción original	El ID de suscripción asociado con la suscripción original, antes de que ocurriera una actualización, venta superior o venta cruzada.	cadena	0912187401000000099
originalClientAcccnum	El número de cuenta comercial asociado con la suscripción original, antes de que ocurriera una actualización, venta superior o venta cruzada.	int	900003
originalClienteSubacc	El número de subcuenta del comerciante asociado con la suscripción original, antes de que ocurriera una actualización, venta superior o venta cruzada.	short	0005
fuente	La fuente de una actualización, venta superior, venta cruzada o cancelación.	cadena	FORMULARIO, API o TELÉFONO

UpSaleÉxito

Igual que NuevaVentaÉxito pero con estos parámetros adicionales agregados. NewSaleSuccess tiene varias versiones; tenga cuidado de usar la versión apropiada de ese Webhook cuando codifique para este Webhook.

UpSaleFracaso

Lo mismo que NuevaVentaFracaso pero con estos parámetros adicionales agregados. NewSaleFailure tiene varias versiones; tenga cuidado de usar la versión apropiada de ese Webhook cuando codifique para este Webhook.

CrossSaleÉxito

Lo mismo que NuevaVentaÉxito pero con estos parámetros adicionales agregados. NewSaleSuccess tiene varias versiones; tenga cuidado de usar la versión apropiada de ese Webhook cuando codifique para este Webhook.

Fallo De Venta Cruzada

Lo mismo que NuevaVentaFracaso pero con estos parámetros adicionales agregados. NewSaleFailure tiene varias versiones; tenga cuidado de usar la versión apropiada de ese Webhook cuando codifique para este Webhook.

Cancelación

formatos compatibles: URL codificada, JSON

Nombre de la variable	Descripción	Tipo de datos (longitud máxima)	Valor de ejemplo
ID de suscripción	Número de identificación de suscripción (solo URL de publicación de aprobación).	bigint (20) no firmado	1000000000
clienteAccnum	Número de cuenta principal de CCBill Merchant.	mediano (6) no firmado	900100
clienteSubacc	Número de subcuenta del comerciante de CCBill.	smallint (4) no firmado cerofill	0000
fecha y hora	Hora en que ocurrió el evento.	datos	2021‐08‐05 15:18:17
razón	La Razón dada para una cancelación, devolución de cargo, reembolso o anulación, si corresponde.	cadena	Cliente reembolsado, comprobante de cancelación, webmaster, cancelación facturada.
fuente	La fuente de una actualización, venta superior, venta cruzada o cancelación.	cadena	FORMULARIO, API o TELÉFONO

Vencimiento

formatos compatibles: URL codificada, JSON

Nombre de la variable	Descripción	Tipo de datos (longitud máxima)	Valor de ejemplo
ID de suscripción	Número de identificación de suscripción (solo URL de publicación de aprobación).	bigint (20) no firmado	1000000000
clienteAccnum	Número de cuenta principal de CCBill Merchant.	mediano (6) no firmado	900100
clienteSubacc	Número de subcuenta del comerciante de CCBill.	smallint (4) no firmado cerofill	0000
fecha y hora	Hora en que ocurrió el evento.	datos	2021‐08‐05 15:18:17

Cambio de fecha de facturación

formatos compatibles: URL codificada, JSON

Nombre de la variable	Descripción	Tipo de datos (longitud máxima)	Valor de ejemplo
ID de suscripción	Número de identificación de suscripción (solo URL de publicación de aprobación).	bigint (20) no firmado	1000000000
clienteAccnum	Número de cuenta principal de CCBill Merchant.	mediano (6) no firmado	900100
clienteSubacc	Número de subcuenta del comerciante de CCBill.	smallint (4) no firmado cerofill	0000
fecha y hora	Hora en que ocurrió el evento.	datos	2021‐08‐05 15:18:17
siguienteFecha de renovación	Próxima fecha de facturación para suscripciones recurrentes.	cadena	2021-09-19

Actualización de datos del cliente

Este webhook solo se activa cuando un cliente modifica su información de facturación a través de https://support.ccbill.com/. No se activará cuando se modifique la información de inicio de sesión de un cliente dentro del administrador de CCBill.

Este evento tiene más de una versión. Haga clic en la pestaña de la versión que desea ver.

RenewalSuccess (Refacturación)

Este evento tiene más de una versión. Haga clic en la pestaña de la versión que desea ver.

Fallo de renovación (renovación de la factura rechazada)

Este evento tiene más de una versión. Haga clic en la pestaña de la versión que desea ver.

Contracargo

Este evento tiene más de una versión. Haga clic en la pestaña de la versión que desea ver.

Ida y vuelta

Este evento tiene más de una versión. Haga clic en la pestaña de la versión que desea ver.

Reembolso

Este evento tiene más de una versión. Haga clic en la pestaña de la versión que desea ver.

Void

Este evento tiene más de una versión. Haga clic en la pestaña de la versión que desea ver.

Apéndice A: Códigos de moneda

Código numérico de moneda	Código de letras de moneda	Nombre de moneda
036	MXN	Dólar australiano
124	CAD	Dolar canadiense
392	JPY	Yen japonés
826	GBP	Reino Unido Libra
840	USD	Dólar estadounidense
978	EUR	Países miembros de la zona euro

Apéndice B: Códigos de rechazo

Código de rechazo	Rechazar texto
1	El sitio web no está disponible para registrarse
2	No se pueden determinar los requisitos de registro en el sitio web
3	No se acepta tu tipo de tarjeta, prueba con otro tipo de tarjeta de crédito
4	Error del sistema bancario
5	La tarjeta de crédito que ingresaste no es válida
6	Verifique para asegurarse de haber ingresado su fecha de vencimiento Se utiliza para mostrar las fechas anuales, mensuales o diarias correspondientes individuales para los datos del informe. El formato de la función de fecha es año-mes-día; por ejemplo, 2002-01-01. correctamente
7	Verifique para asegurarse de haber ingresado su número de cuenta bancaria correctamente
8	Verifique para asegurarse de haber ingresado correctamente el número de ruta de su banco
9	Error del sistema bancario, inténtelo de nuevo
10	El sitio web tiene un precio no válido
11	Transaccion rechazada
12	Actualmente tiene una suscripción y no puede registrarse
13	Ya ha tenido una prueba gratuita
14	Debe ingresar su número CVV2 en el reverso de su tarjeta
15	Su cuenta se está procesando actualmente, consulte el sitio web al que se está uniendo para ver si tiene acceso. Si no, por favor contacte soporte@ecsuite.com
16	El ID de suscripción proporcionado no es válido
17	El ID de suscripción no existe en el sistema
18	Se rechazó el intento de transacción anterior en la solicitud
19	No está autorizado para registrarse con las credenciales proporcionadas
20	Sin declive
21	Ya tuvo una prueba, seleccione una opción de membresía recurrente normal
22	Se produjo un error al comunicarse con el banco. Vuelva a intentarlo más tarde.
23	Se proporcionó una tarjeta de crédito no válida
24	Transacción denegada por el banco
25	Error bancario
26	Configuración de procesamiento de tarjetas incorrecta para el comerciante
27	Error del sistema, por favor, inténtalo de nuevo
28	No podemos procesar su transacción en este momento. Porfavor intente más tarde
29	Tarjeta caducada
30	No podemos facturar el número de teléfono proporcionado para esta transacción. Regrese al sitio web y elija un método de pago alternativo.
31	Fondos insuficientes
32	Debe proporcionar CVV2 para completar la transacción
33	No se pudo determinar el tipo de transacción
34	Se produjo un error al comunicarse con el banco. Vuelva a intentarlo más tarde.
35	Tarjeta rechazada en Pre-Auth SC
36	No se puede contactar con el banco
37	Actualmente no procesamos para la papelera de su banco
38	Transacción rechazada por el banco emisor
39	Has enviado demasiadas veces hoy
40	Este comerciante no acepta la tarjeta que está utilizando
41	Comerciante inactivo
42	Dirección incorrecta proporcionada
43	No podemos procesar su transacción de facturación telefónica porque su proveedor solo permite un cargo, por número de teléfono, por día, y nuestros registros muestran que tiene un cargo diario existente para este número de teléfono. Regrese al sitio web y elija un método de pago alternativo.
44	Lo sentimos, en este momento no se permiten tarjetas prepagas. Pruebe con otro tipo de tarjeta.
45	La transacción requiere aprobación adicional: consulte su correo electrónico de confirmación para obtener más instrucciones.

ChangeLog

Lanzamiento 1:

Versión inicial.

Lanzamiento 2:

30 de octubre 2013

• Agrega soporte para el control de versiones:
  • Las nuevas configuraciones siempre se crean utilizando la versión actual (más reciente).
  • Agregar un evento a una configuración existente agrega el evento a la versión actual sin importar la versión de los eventos existentes.
  • A los comerciantes que utilicen versiones anteriores se les ofrecerá la opción de actualizar a una nueva versión en las configuraciones existentes.
• Crea una nueva versión de los siguientes eventos:
  • NewSaleSuccess: Agrega Cuenta de pago campo.
  • RenewalSuccess: agrega Fecha de renovación campo.
  • RenewalFailure: agrega Fecha de renovación campo.
• Crea los siguientes eventos nuevos:
  • Devolución: notifica al usuario cuando CCBill recibe una devolución de cheque.
• Corrección de errores:
  • Corrige un error que resultó en una POST incorrecta de los campos failureCode, failureReason y transactionId en Cross Sales, Cross Sale API y Upgrades con specialOffer.
  • Corrige un error que resultó en una POST incorrecta de los campos failureCode, failureReason y transactionId para Upsales.
  • Corrige un error que causaba que el subscriptionTypeId se enviara incorrectamente.

Lanzamiento 3:

24 abril 2014

• Agrega una nueva variable llamada identificación flexible a algunos Webhooks para acomodar e identificar las ventas realizadas con FlexForms (actualmente en estado OPEN BETA). Actualizar sus Webhooks a la versión que incluye esta variable no causará ninguna complicación para los usuarios que no son parte de la Beta ya que el campo NO ENVIAR si la compra fue creada usando los formularios actuales de CCBill.
  • La adición de esta variable afectó a los siguientes Webhooks:
    • NewSaleSuccess: agrega la versión 3
    • NewSaleFailure: agrega la versión 2
    • UpSaleSuccess: debido a que este Webhook se basa en NewSaleSuccess, se agregaron notas para recordar a los usuarios que deben hacer referencia a la versión correcta de ese Webhook al codificar este Webhook.
    • UpSaleFailure: debido a que este Webhook se basa en NewSaleFailure, se agregaron notas para recordar a los usuarios que deben hacer referencia a la versión correcta de ese Webhook al codificar para este Webhook.
    • CrossSaleSuccess: debido a que este Webhook se basa en NewSaleSuccess, se agregaron notas para recordar a los usuarios que deben hacer referencia a la versión correcta de ese Webhook al codificar este Webhook.
    • CrossSaleFailure: debido a que este Webhook se basa en NewSaleFailure, se agregaron notas para recordar a los usuarios que deben hacer referencia a la versión correcta de ese Webhook cuando codifiquen este Webhook.

Lanzamiento 4:

13 abril 2017

• Se mejora la seguridad agregando el soporte para TLS 1.2 protocolo de cifrado. Los más altos estándares de seguridad proporcionarán un entorno más seguro y promoverán la seguridad de los datos de los clientes.
• Se agregan dos nuevas variables:
  • fecha de caducidad: los comerciantes ahora saben cuándo caducará la tarjeta de un consumidor. Luego, la notificación se puede enviar de manera proactiva para informar a los consumidores que actualicen la información de la tarjeta. Esto mejorará la experiencia general de los consumidores. La adición de la variable expDate afectó a los siguientes Webhooks:
    • NewSaleSuccess: este evento contiene el parámetro en la versión 4.
    • CustomerDataUpdate: este evento contiene el parámetro en la versión 2.
    • Contracargo: este evento contiene el parámetro en la versión 2.
    • Reembolso: este evento contiene el parámetro en la versión 2.
    • RenewalSuccess: este evento contiene el parámetro en la versión 3.
    • Void: este evento contiene el parámetro en la versión 2.
  • last4: los comerciantes ahora pueden mantener datos de consumidores más completos al recibir información parcial sobre el método de pago. El parámetro incluirá los últimos cuatro (4) dígitos del número de tarjeta de crédito para transacciones con tarjeta de crédito o los últimos cuatro dígitos del número de cuenta bancaria para transacciones con cheques. La adición de la variable last4 afectó a los siguientes Webhooks:
    • NewSaleSuccess: este evento contiene el parámetro en la versión 4.
    • CustomerDataUpdate: este evento contiene el parámetro en la versión 2.
    • Contracargo: este evento contiene el parámetro en la versión 2.
    • Reembolso: este evento contiene el parámetro en la versión 2.
    • RenewalSuccess: este evento contiene el parámetro en la versión 3.
    • Void: este evento contiene el parámetro en la versión 2.

Lanzamiento 5:

11 de mayo de 2017

Nuevo parámetro papelera se agrega y los comerciantes ahora pueden recibir el BIN de la tarjeta de crédito, lo que les permite realizar un mejor seguimiento de las tendencias de los consumidores.

• La adición de la papelera El parámetro afectó a los siguientes Webhooks:
  • NewSaleSuccess: este evento contiene el parámetro en la versión 5.
  • UpgradeSuccess: este evento contiene el parámetro en la versión 2.
  • UpSaleSuccess: este evento contiene el parámetro en la versión 3.
  • CrossSaleSuccess: este evento contiene el parámetro en la versión 3.
  • CustomerDataUpdate: este evento contiene el parámetro en la versión 3.
  • Contracargo: este evento contiene el parámetro en la versión 3.

• El sistema tipo de pago El parámetro se agregó a los siguientes Webhooks:
  • Contracargo: este evento contiene el parámetro en la versión 3.
  • Retorno: este evento contiene el parámetro en la versión 3.
  • Reembolso: este evento contiene el parámetro en la versión 3.
  • RenewalSuccess: este evento contiene el parámetro en la versión 4.
  • RenewalFailure: este evento contiene el parámetro en la versión 3.
  • Void: este evento contiene el parámetro en la versión 3.

• El sistema tipo de tarjeta El parámetro se agregó a los siguientes Webhooks:
  • Contracargo: este evento contiene el parámetro en la versión 3.
  • Reembolso: este evento contiene el parámetro en la versión 3.
  • RenewalSuccess: este evento contiene el parámetro en la versión 4.
  • RenewalFailure: este evento contiene el parámetro en la versión 3.
  • Void: este evento contiene el parámetro en la versión 3.

Lanzamiento 6:

1 de junio de 2017

Los siguientes parámetros se han agregado y / o han afectado a estos Webhooks y versiones:

• El sistema Cuenta de pago parámetro:
  • CustomerDataUpdate: este evento contiene el parámetro en la versión 4.
  • Contracargo: este evento contiene el parámetro en la versión 4.
  • Reembolso: este evento contiene el parámetro en la versión 4.
  • Retorno: este evento contiene el parámetro en la versión 4.
  • RenewalSuccess: este evento contiene el parámetro en la versión 5.
  • Void: este evento contiene el parámetro en la versión 4.

• El sistema contabilidadMoneda parámetro:
  • Contracargo: este evento contiene las actualizaciones en todas las versiones.
  • Reembolso: este evento contiene las actualizaciones en todas las versiones.
  • RenewalSuccess: este evento contiene las actualizaciones en todas las versiones.
  • Anulado: este evento contiene las actualizaciones en todas las versiones.

• El sistema moneda parámetro:
  • Contracargo: este evento contiene las actualizaciones en todas las versiones.
  • Reembolso: este evento contiene las actualizaciones en todas las versiones.
  • Anulado: este evento contiene las actualizaciones en todas las versiones.

• El sistema moneda facturada parámetro:
  • RenewalSuccess: este evento contiene las actualizaciones en todas las versiones.

Lanzamiento 7:

19 de julio de 2017

• Se ha agregado la capacidad de recibir datos de Webhook en JSON (notación de objetos JavaScript). El formato original se denominará "codificado en URL".

Lanzamiento 8:

Febrero 11, 2020

• Nuevo tresDSecure Se ha agregado un parámetro que permite a los comerciantes realizar un seguimiento de los resultados de la autenticación 3DS.
  • La adición de la tresDSecure El parámetro afectó a los siguientes Webhooks:
    • NewSaleSuccess: este evento contiene el parámetro en la versión 6.
    • NewSaleFailure: este evento contiene el parámetro en la versión 3.