Guía del usuario de precios dinámicos

Descripción

La Guía del usuario de Dynamic Pricing es un recurso técnico destinado a programadores, técnicos y otras personas con conocimientos avanzados de codificación.

La función de precios dinámicos de CCBill permite a los comerciantes pasar variables directamente al formulario de registro y crear nuevas opciones de precios de forma dinámica. Los comerciantes pueden generar precios sobre la marcha utilizando campos de formulario HTML ocultos o incluyendo variables en una cadena de solicitud de URL.

Las variables pasadas definen la estructura de precios y permiten a los comerciantes crear precios únicos y recurrentes.

Los sistemas FlexForms y JPost utilizan diferentes parámetros para generar puntos de precios dinámicos.

Requisitos previos

Los comerciantes deben asegurarse de que su cuenta y subcuenta de comerciante estén configuradas para Dynamic Pricing:

¿No está seguro de cumplir con estos requisitos? Por favor contactar Soporte para comerciantes de CCBill para verificar la configuración de su sistema de precios dinámicos.

Parámetros de precios dinámicos - FlexForms

La URL base para enviar solicitudes de precios dinámicos cuando se usa FlexForms es:

https://api.ccbill.com/wap-frontflex/flexforms

El sistema FlexForms otorga a cada flujo de pago un Flex ID único. Flex ID le dice al sistema qué forma de pago usar cuando se muestran precios dinámicos.

Flex ID en el portal de administración.


El Flex ID es una parte integral de la cadena de precios dinámicos y es el primer valor que se debe incluir en cada solicitud de precios dinámicos:

https://api.ccbill.com/wap-frontflex/flexforms/687fa3e0-e60d-4466-88e2-181fa56dd6a9

Se agregan variables adicionales a la URL base y al ID de Flex. El conjunto de variables que se pasan al formulario depende del tipo de transacción y de si el comerciante desea crear un punto de precio único o recurrente.

Variables de facturación únicas


PARÁMETRODESCRIPCIÓNVALOR DE EJEMPLO
clienteSubaccUn número entero que representa el número de subcuenta de comerciante de 4 dígitos.0000
precio inicialUn valor decimal (dos decimales) que representa el precio inicial.10.00
periodo inicialUn número entero que representa la duración, en días, del período de facturación inicial. Por defecto, el valor de los precios no recurrentes está entre 2 y 365.30
código de monedaUn número entero que representa el código de moneda de 3 dígitos que se usará para la transacción.DÓLAR ESTADOUNIDENSE - 840
YO R - 978
GBP - 826
CANALLA 124
AUD - 036
GUAY - 392
formularioDigestUn hash MD5 de parámetros de pago y un único Clave de encriptación. Explore nuestra guía detallada sobre cómo crear valores formDigest para FlexForms.a7459445d0e5dc0963fe736dc5cf900b

Ejemplos de código

Un ejemplo de una solicitud de precio dinámico FlexForms no recurrente incluye las siguientes variables:

https://api.ccbill.com/wap-frontflex/flexforms/687fa3e0-e60d-4466-88e2-181fa56dd6a9?clientSubacc=0000&initialPrice=10.00&initialPeriod=30&currencyCode=840&formDigest=a7459445d0e5dc0963fe736dc5cf900b

También puede llamar flujos de pago específicos y pasar las variables de fijación de precios dinámicas utilizando el Widget web de CCBill:

<div class=”ccbillWidgetContainer”>
<script type="text/javascript" class="CCBillWidget687fa3e0-e60d-4466-88e2-181fa56dd6a9_109" src="https://images.ccbill.com/flexforms/ccbill-widget-live.js">
     
{ "parameters" :                
         {   
         "clientSubacc" : "0000",
         "initialPrice" : "10.00",      
         "initialPeriod" : "30", 
         "currencyCode" : "840",
         "formDigest" : "48f0b12e4307e64edb781c479665c899"           
         }
} 
      
</script> 
</div>

Variables de precios recurrentes


PARÁMETRODESCRIPCIÓNVALOR DE EJEMPLO
clienteSubaccUn número entero que representa el número de subcuenta de comerciante de 4 dígitos.0000
precio inicialUn valor decimal (dos decimales) que representa el precio inicial.10.00
periodo inicialUn número entero que representa la duración, en días, del período de facturación inicial. Por defecto, el valor de los precios no recurrentes está entre 2 y 365.30
Precio recurrenteUn valor decimal (dos decimales) que representa el precio recurrente.10.00
período recurrenteUn número entero que representa la duración, en días, del período de facturación recurrente. Los valores predeterminados para los precios recurrentes son 30, 60 y 90.30
numRefacturacionesUn número entero de refacturaciones. El valor predeterminado para los precios recurrentes es 99.99
código de monedaUn número entero que representa el código de moneda de 3 dígitos que se usará para la transacción.DÓLAR ESTADOUNIDENSE - 840
YO R - 978
GBP - 826
CANALLA 124
AUD - 036
GUAY - 392
formularioDigestUn hash MD5 de parámetros de pago y un único Clave de encriptación. Explore nuestra guía detallada sobre cómo crear valores formDigest para FlexForms.48f0b12e4307e64edb781c479665c899

Ejemplos de código

Un ejemplo de una solicitud de precio dinámico FlexForms no recurrente incluye las siguientes variables:

https://api.ccbill.com/wap-frontflex/flexforms/687fa3e0-e60d-4466-88e2-181fa56dd6a9?clientSubacc=0000&initialPrice=10.00&initialPeriod=30&recurringPrice=10.00&recurringPeriod=30&numRebills=99&currencyCode=840&formDigest=48f0b12e4307e64edb781c479665c899

También puede llamar flujos de pago específicos y pasar las variables de fijación de precios dinámicas utilizando el Widget web de CCBill:

<div class=”ccbillWidgetContainer”>
<script type="text/javascript" class="CCBillWidget687fa3e0-e60d-4466-88e2-181fa56dd6a9_109" src="https://images.ccbill.com/flexforms/ccbill-widget-live.js">         
{ "parameters" :                
         { 
         "clientSubacc" : "0000",
         "initialPrice" : "10.00",      
         "initialPeriod" : "30", 
         "recurringPrice" : "10.00",
         "recurringPeriod" : "30",
         "numRebills" : "99",      
         "currencyCode" : "840",
         "formDigest" : "48f0b12e4307e64edb781c479665c899"            
         }
}         
</script> 
</div>

Valor de resumen de respuesta

Comerciantes que usan Dynamic Pricing y Webhooks recibir un DynamicPricingValidationDigest valor después de un evento de transacción exitosa o fallida.

Si está utilizando el Sistema de publicaciones en segundo plano, recibirás el resumen de respuesta valor en su lugar.

Este valor es un hash MD5 de los resultados de la transacción que se puede usar para verificar que CCBill recibió la respuesta correctamente.

Transacciones Aprobadas

La resumen de respuesta or DynamicPricingValidationDigest valores para aprobada las transacciones se generan de la misma manera. El sistema de CCBill crea una sola cadena a partir de los siguientes valores y los codifica (MD5):

VALORDESCRIPCIÓN
ID de suscripciónEl número de identificación de suscripción único para la suscripción.
1Este valor es simplemente el número 1 (uno), utilizado para mostrar que la transacción fue aprobada.
salLa misma clave de cifrado utilizada para generar el formularioDigest valor. Usted puede recuperar la clave de cifrado/sal del administrador de CCBill.

Estos valores se enviarán a la URL de publicación de aprobación o a la URL de webhooks configurada para NuevaVentaÉxito.

Transacciones denegadas

La resumen de respuesta or DynamicPricingValidationDigest valores para negado las transacciones se generan de la misma manera. El sistema de CCBill crea una sola cadena a partir de los siguientes valores y los codifica (MD5):

VALORDESCRIPCIÓN
ID de suscripciónEl número de identificación de suscripción único para la suscripción.
0Este valor es simplemente el número 0 (cero), que se usa para mostrar que la transacción fue denegada.
salLa misma clave de cifrado utilizada para generar el formularioDigest valor. Usted puede recuperar la clave de cifrado/sal del administrador de CCBill.

Estos valores se enviarán a la URL de la publicación de denegación o a la URL configurada para nuevaventafallas en Webhooks.

El sistema de CCBill devuelve códigos de error si no se puede generar una opción de precio dinámico en el formulario de pago. Descubra cómo corregir códigos de error de precios dinámicos si eso pasa.


Parámetros de precios dinámicos (formularios de pago JPost)

La URL base para enviar solicitudes de precios dinámicos cuando se utilizan formularios JPost es:

https://bill.ccbill.com/jpost/signup.cgi

Se agregan variables adicionales a la URL base. El conjunto de variables que se pasan al formulario depende del tipo de transacción y de si el comerciante desea crear un punto de precio único o recurrente.

Variables de facturación únicas


PARÁMETRODESCRIPCIÓNVALOR DE EJEMPLO
clienteAccnumUn valor entero que representa el número de cuenta de comerciante de 6 dígitos.900000
clienteSubaccUn número entero que representa el número de subcuenta de comerciante de 4 dígitos.0000
nombre del formularioEl nombre del formulario de pago JPost.104cc
formularioPrecioUn valor decimal (dos decimales) que representa el precio inicial.10.00
formularioPeríodoUn número entero que representa la duración, en días, del período de facturación inicial. Por defecto, el valor de los precios no recurrentes está entre 2 y 365.30
código de monedaUn número entero que representa el código de moneda de 3 dígitos que se usará para la transacción.DÓLAR ESTADOUNIDENSE - 840
YO R - 978
GBP - 826
CANALLA 124
AUD - 036
GUAY - 392
formularioDigestUn hash MD5 de parámetros de pago y un único Clave de encriptación. Explore nuestra guía detallada sobre cómo crear valores formDigest para FlexForms.a7459445d0e5dc0963fe736dc5cf900b

Ejemplos de código

Un ejemplo de una solicitud de precio dinámico no recurrente en JPost incluye las siguientes variables:

https://bill.ccbill.com/jpost/signup.cgi?clientAccnum=900000&clientSubacc=0000&formName=104cc&formPrice=10.00&formPeriod=30&currencyCode=840&formDigest=a7459445d0e5dc0963fe736dc5cf900b

Las variables también se pueden pasar utilizando campos ocultos en un formulario HTML. El siguiente ejemplo muestra un posible código para un botón que llevará al consumidor al formulario de registro:

<form id="myForm" method="post" action="https://bill.ccbill.com/jpost/signup.cgi"> 
<input type="hidden" name="clientAccnum" value="900000"> 
<input type="hidden" name="clientSubacc” value="0000"> 
<input type="hidden" name="formName” value="104cc"> 
<input type="hidden" name="formPrice” value="10.00"> 
<input type="hidden" name="formPeriod” value="30"> 
<input type="hidden" name="currencyCode" value="840"> 
<input type="hidden" name="formDigest" value="a7459445d0e5dc0963fe736dc5cf900b"> 
<input type="submit" value="Join Now!">
</form>

Variables de facturación recurrentes


PARÁMETRODESCRIPCIÓNVALOR DE EJEMPLO
clienteAccnumUn valor entero que representa el número de cuenta de comerciante de 6 dígitos.900000
clienteSubaccUn número entero que representa el número de subcuenta de comerciante de 4 dígitos.0000
nombre del formularioEl nombre de la forma de pago.211cc
formularioPrecioUn valor decimal (dos decimales) que representa el precio inicial.10.00
formularioPeríodoUn número entero que representa la duración, en días, del período de facturación inicial. Por defecto, el valor de los precios no recurrentes está entre 2 y 365.30
formularioPrecioRecurrenteUn valor decimal (dos decimales) que representa el precio recurrente.10.00
formularioRrecurringPeriodUn número entero que representa la duración, en días, del período de facturación recurrente. Los valores predeterminados para los precios recurrentes son 30, 60 y 90.30
formularioRebillsUn número entero de refacturaciones. El valor predeterminado para los precios recurrentes es 99.99
código de monedaUn número entero que representa el código de moneda de 3 dígitos que se usará para la transacción.DÓLAR ESTADOUNIDENSE - 840
YO R - 978
GBP - 826
CANALLA 124
AUD - 036
GUAY - 392
formularioDigestUn hash MD5 de parámetros de pago y un único Clave de encriptación. Explore nuestra guía detallada sobre cómo crear valores formDigest para FlexForms.48f0b12e4307e64edb781c479665c899

Ejemplos de código

El siguiente ejemplo muestra los datos que se pasan a través de la cadena de URL:

https://bill.ccbill.com/jpost/signup.cgi?clientAccnum=900000&clientSubacc=0000&formName=211cc&formPrice=10.00&formPeriod=30&formRecurringPrice=10.00&formRecurringPeriod=30&currencyCode=840&formRebills=99&formDigest=a7459445d0e5dc0963fe736dc5cf900b

Las variables también se pueden pasar utilizando campos ocultos en un formulario HTML. El siguiente ejemplo muestra un posible código para un botón que llevará al consumidor al formulario de registro:

<form id="myForm" method="post" action="https://bill.ccbill.com/jpost/signup.cgi"> 
<input type="hidden" name="clientAccnum" value="900000"> 
<input type="hidden" name="clientSubacc” value="0000"> 
<input type="hidden" name="formName” value="211cc"> 
<input type="hidden" name="formPrice” value="10.00"> 
<input type="hidden" name="formPeriod” value="30"> 
<input type="hidden" name="formRecurringPrice" value="10.00"> 
<input type="hidden" name="formRecurringPeriod" value="30"> 
<input type="hidden" name="currencyCode" value="840"> 
<input type="hidden" name="formRebills" value="99"> 
<input type="hidden" name="formDigest" value="a7459445d0e5dc0963fe736dc5cf900b"> 
<input type="submit" value="Join Now!"> 
</form>

Valor de resumen de respuesta

Comerciantes que usan Dynamic Pricing y Webhooks recibir un DynamicPricingValidationDigest valor después de un evento de transacción exitosa o fallida.

Si está utilizando el Sistema de publicaciones en segundo plano, recibirás el resumen de respuesta valor en su lugar.

Este valor es un hash MD5 de los resultados de la transacción que se puede usar para verificar que CCBill recibió la respuesta correctamente.

Transacciones Aprobadas

La resumen de respuesta or DynamicPricingValidationDigest valores para aprobada las transacciones se generan de la misma manera. El sistema de CCBill crea una sola cadena a partir de los siguientes valores y los codifica (MD5):

VALORDESCRIPCIÓN
ID de suscripciónEl número de identificación de suscripción único para la suscripción.
1Este valor es simplemente el número 1 (uno), utilizado para mostrar que la transacción fue aprobada.
salLa misma clave de cifrado utilizada para generar el formularioDigest valor. Usted puede recuperar la clave de cifrado/sal del administrador de CCBill.

Estos valores se enviarán a la URL de publicación de aprobación o a la URL de webhooks configurada para NuevaVentaÉxito.

Transacciones denegadas

La resumen de respuesta or DynamicPricingValidationDigest valores para negado las transacciones se generan de la misma manera. El sistema de CCBill crea una sola cadena a partir de los siguientes valores y los codifica (MD5):

VALORDESCRIPCIÓN
ID de suscripciónEl número de identificación de suscripción único para la suscripción.
0Este valor es simplemente el número 0 (cero), que se usa para mostrar que la transacción fue denegada.
salLa misma clave de cifrado utilizada para generar el formularioDigest valor. Usted puede recuperar la clave de cifrado/sal del administrador de CCBill.

Estos valores se enviarán a la URL de la publicación de denegación o a la URL configurada para nuevaventafallas en Webhooks.

El sistema de CCBill devuelve códigos de error si no se puede generar una opción de precio dinámico en el formulario de pago. Descubra cómo corregir códigos de error de precios dinámicos si eso pasa.