Guía del usuario de precios dinámicos

General

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:

Los precios dinámicos deben estar habilitados en la subcuenta utilizada para la transacción.
Un clave de cifrado es un requisito para creando el valor del parámetro formDigest.
Los precios dinámicos deben estar habilitados en el formulario de pago (Sistema FlexForms solamente).

¿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.

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ÁMETRO	DESCRIPCIÓN	VALOR DE EJEMPLO
clienteSubacc	Un número entero que representa el número de subcuenta de comerciante de 4 dígitos.	0000
precio inicial	Un valor decimal (dos decimales) que representa el precio inicial.	10.00
periodo inicial	Un 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 moneda	Un 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
formularioDigest	Un 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ÁMETRO	DESCRIPCIÓN	VALOR DE EJEMPLO
clienteSubacc	Un número entero que representa el número de subcuenta de comerciante de 4 dígitos.	0000
precio inicial	Un valor decimal (dos decimales) que representa el precio inicial.	10.00
periodo inicial	Un 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 recurrente	Un valor decimal (dos decimales) que representa el precio recurrente.	10.00
período recurrente	Un 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
numRefacturaciones	Un número entero de refacturaciones. El valor predeterminado para los precios recurrentes es 99.	99
código de moneda	Un 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
formularioDigest	Un 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 aprobado 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):

VALOR	DESCRIPCIÓN
ID de suscripción	El número de identificación de suscripción único para la suscripción.
1	Este valor es simplemente el número 1 (uno), utilizado para mostrar que la transacción fue aprobada.
sal	La 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):

VALOR	DESCRIPCIÓN
ID de suscripción	El número de identificación de suscripción único para la suscripción.
0	Este valor es simplemente el número 0 (cero), que se usa para mostrar que la transacción fue denegada.
sal	La 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ÁMETRO	DESCRIPCIÓN	VALOR DE EJEMPLO
clienteAccnum	Un valor entero que representa el número de cuenta de comerciante de 6 dígitos.	900000
clienteSubacc	Un número entero que representa el número de subcuenta de comerciante de 4 dígitos.	0000
nombre del formulario	El nombre del formulario de pago JPost.	104cc
formularioPrecio	Un valor decimal (dos decimales) que representa el precio inicial.	10.00
formularioPeríodo	Un 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 moneda	Un 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
formularioDigest	Un 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ÁMETRO	DESCRIPCIÓN	VALOR DE EJEMPLO
clienteAccnum	Un valor entero que representa el número de cuenta de comerciante de 6 dígitos.	900000
clienteSubacc	Un número entero que representa el número de subcuenta de comerciante de 4 dígitos.	0000
nombre del formulario	El nombre de la forma de pago.	211cc
formularioPrecio	Un valor decimal (dos decimales) que representa el precio inicial.	10.00
formularioPeríodo	Un 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
formularioPrecioRecurrente	Un valor decimal (dos decimales) que representa el precio recurrente.	10.00
formularioRrecurringPeriod	Un 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
formularioRebills	Un número entero de refacturaciones. El valor predeterminado para los precios recurrentes es 99.	99
código de moneda	Un 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
formularioDigest	Un 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

<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

VALOR	DESCRIPCIÓN
ID de suscripción	El número de identificación de suscripción único para la suscripción.
1	Este valor es simplemente el número 1 (uno), utilizado para mostrar que la transacción fue aprobada.
sal	La 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

VALOR	DESCRIPCIÓN
ID de suscripción	El número de identificación de suscripción único para la suscripción.
0	Este valor es simplemente el número 0 (cero), que se usa para mostrar que la transacción fue denegada.
sal	La 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.