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.
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.
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.
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.
| descuentoSuscripción | clienteSubacc | usandoSubacc | ID de suscripción | retornoXML | importeDescuento |
|---|---|---|---|---|---|
| Cuenta principal | O | O | X | X | |
| Cuenta principal con XML | O | O | X | X | X |
| Sub-cuenta | O | O | X | X | |
| Subcuenta con XML | O | O | X | X | X |
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"
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
| descuentoSuscripción | clienteSubacc | usandoSubacc | ID de suscripción | retornoXML | nuevoPrecioRecurrente |
|---|---|---|---|---|---|
| Cuenta principal | O | O | X | X | |
| Cuenta principal con XML | O | O | X | X | X |
| Sub-cuenta | O | O | X | X | |
| Subcuenta con XML | O | O | X | X | X |
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"
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
| Code | Descripción | Más Información |
|---|---|---|
| -2 | El 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. |
| -18 | El 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). |
| -19 | El 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). |
| -20 | El 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. |
| -21 | No 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. |
| -22 | Esta suscripción no es elegible para un descuento. | Los descuentos solo se pueden aplicar a una prueba activa o una suscripción recurrente activa. |
| Versión | Fecha | cambio de registro |
|---|---|---|
| 1 | 1.16.2014 | Nueva documentación de llamadas a la API de CCBill. |