API CCBill: API de descuento directo

Introducción

Este documento se publica como un anexo a la documentación de la API de CCBill y analiza la funcionalidad de descuento de suscripción. Este documento está escrito para desarrolladores, técnicos y otras personas con habilidades de codificación avanzadas.

RESUMEN

CCBill ha agregado llamadas a la API de CCBill que permiten a los usuarios descontar suscripciones como una herramienta adicional para la retención de consumidores. Se ha agregado la misma funcionalidad al portal de administración de CCBill para aquellos que no pueden acceder al sistema a través de la API.

Exclusiones

Los parámetros que siempre son obligatorios (como clientAccnum, nombre de usuario, contraseña, etc.) se excluyen de este cuadro y se analizan en la sección principal. API CCBill.

descuentoSuscripción

La llamada discountSubscription le permite descontar la suscripción por un monto fijo o un precio recurrente completamente nuevo, dependiendo de los parámetros enviados con la llamada.

Descuento por cantidad

Parámetros obligatorios (X) y opcionales (O)

descuentoSuscripciónclienteSubaccusandoSubaccID de suscripciónretornoXMLimporteDescuento
Cuenta principalOOXX
Cuenta principal con XMLOOXXX
Sub-cuentaOOXX
Subcuenta con XMLOOXXX

EJEMPLO DE VERSIÓN CSV

Solicitar cadena

https://datalink.ccbill.com/utils/subscriptionManagement.cgi?clientAccnum=900112&clientSubacc=0000&username=yourUsername&password=yourPassword&discountAmount=2.00&action=discountSubscription&subscriptionId=1113346401000000080

Respuesta

"resultados" "-10"

EJEMPLO DE VERSIÓN XML

Solicitar cadena

https://datalink.ccbill.com/utils/subscriptionManagement.cgi?clientAccnum=900112&clientSubacc=0000&username=yourUsername&password=yourPassword&discountAmount=2.00&action=discountSubscription&subscriptionId=1113346401000000080&returnXML=1

Respuesta

-1.0

Establecer nuevo precio recurrente

descuentoSuscripciónclienteSubaccusandoSubaccID de suscripciónretornoXMLnuevoPrecioRecurrente
Cuenta principalOOXX
Cuenta principal con XMLOOXXX
Sub-cuentaOOXX
Subcuenta con XMLOOXXX

EJEMPLO DE VERSIÓN CSV

Solicitar cadena

https://datalink.ccbill.com/utils/subscriptionManagement.cgi?clientAccnum=900112&clientSubacc=0000&username=yourUsername&password=yourPassword&newRecurringPrice=18.95&action=discountSubscription&subscriptionId=1113346401000000080

Respuesta

"resultados" "-10"

EJEMPLO DE VERSIÓN XML

Solicitar cadena

https://datalink.ccbill.com/utils/subscriptionManagement.cgi?clientAccnum=900112&clientSubacc=0000&username=yourUsername&password=yourPassword&newRecurringPrice=18.95&action=discountSubscription&subscriptionId=1113346401000000080&returnXML=1

Respuesta

-1.0

Información devuelta

Códigos de error

CódigoDescripciónMás Información
-2El ID de suscripción proporcionado no es válido o el tipo de suscripción no es compatible con la acción solicitada.No se puede transferir un nuevo precio recurrente por una suscripción no recurrente.
-18El precio recurrente es menor que el mínimo permitido.No se puede agregar un descuento a ninguna suscripción que resulte en un precio inferior a 5.00 unidades (a pesar de la moneda).
-19El monto del descuento es menor que el mínimo permitido.El importe del descuento no puede ser inferior a 0.01 unidades (sin perjuicio de la divisa).
-20El nuevo precio recurrente es mayor que el precio recurrente de la suscripción.El sistema no puede procesar un descuento que resulte en un precio más alto que la suscripción actual.
-21No se puede reemplazar el descuento por cancelación con una cantidad menor.El sistema no puede procesar un descuento con esta función que NO da como resultado un precio de suscripción más bajo que un descuento por cancelación ya existente.
-22Esta suscripción no es elegible para un descuento.Los descuentos solo se pueden aplicar a una prueba activa o una suscripción recurrente activa.

Historial de las versiones

VersiónFechacambio de registro
11.16.2014Nueva documentación de llamadas a la API de CCBill.