Módulo CCBill X-Cart

 

Introducción

Esta sección proporciona instrucciones de instalación y configuración para el módulo de facturación CCBill X-Cart. Este documento asume que el lector tiene conocimientos prácticos de X-Cart y ya ha instalado el software X-Cart.

El módulo de facturación CCBill X-Cart permite una fácil integración de su cuenta CCBill dentro de la plataforma de comercio electrónico X-Cart.

La instalación consta de los siguientes pasos:

  1. Instalación del módulo de pago CCBill para X-Cart.
  2. Configurar su cuenta CCBill para usar con X-Cart.
  3. Configurar el módulo con la información de su cuenta CCBill.

INSTALACIÓN

El módulo CCBill X-Cart se instala cargando los archivos en el archivo zip descargado del sitio web de CCBill en su instalación X-Cart. Hay dos carpetas que deben copiarse:

  • / classes / XLite / Module / CCBill / CCBill_Payment
  • / skins / admin / modules / CCBill / CCBill_Payment

Antes de la instalación, si tiene una versión anterior de la pasarela de pago CCBill, elimínela del administrador de X-Cart y luego cargue el nuevo código.

Instalación del módulo

1. Después de cargar los archivos requeridos, inicie sesión en su administrador de X-Cart.

2. En el menú de la izquierda, navega hasta Configuración del sistema> Gestión de caché.

3. Haga clic en el Vuelva a implementar la tienda

4. Una vez completado, seleccione Módulos En el menú de la izquierda.

5. Escribe CCBill en el campo de búsqueda y presione Enviar. Si los archivos se copiaron correctamente, el módulo CCBill aparecerá en sus resultados de búsqueda.

6. Revisa el símbolo de poder para habilitar el módulo.

Pasos para instalar el módulo CCBill en X-Cart.

7. Haga clic en el Guardar cambios en la parte inferior de la página. La tienda se volverá a implementar automáticamente.

Configuración de su cuenta CCBill

Antes de usar el complemento, es necesario configurar algunas cosas en su cuenta CCBill. La siguiente configuración de CCBill debe ser correcta para que el módulo de pago funcione correctamente.

Habilitar precios dinámicos

Trabaje con su representante de soporte de CCBill para activar el precio dinámico para su cuenta. Puede verificar que Dynamic Pricing esté activo en Info de Cuenta > Administrar las subcuentas > Resumen de funciones en el Portal de administración. Su estado de precio dinámico aparece en la parte inferior de la Herramientas de facturación .

Verifique si el precio dinámico está habilitado en CCBill Admin.

Creación de una clave de cifrado / sal

Una "sal" es una cadena de datos aleatorios que se utiliza para hacer que su cifrado sea más seguro. Debe comunicarse con el Soporte para comerciantes de CCBill para generar su clave Salt / Encryption. Una vez configurado, será visible debajo de la Avanzado sección de la Administrador de subcuenta menú. Aparecerá en el clave de cifrado del objeto Actualizar la información de configuración de seguridad .

Ubicación de Salt Key en CCBill Admin.

Desactivación de la gestión de usuarios

Dado que esta cuenta se utilizará para transacciones de precios dinámicos (no para administrar suscripciones de usuarios), la administración de usuarios debe estar deshabilitada.

1. Inicie sesión en Portal de administración.

2. Por Info de Cuenta mega menú, haga clic en Administrador de subcuenta.

3. Abre el Gestión de usuarios .

4. Hacer clic en Desactivar la gestión de usuarios en la sección superior.

5. Seleccionar No recopile nombres de usuario ni contraseñas en la Configuración de nombre de usuario .

Desactivación de la función Gestión de usuarios en CCBill Admin.

Creación de un nuevo formulario de pago

El formulario de pago es el formulario CCBill que se mostrará a los clientes después de que elijan pagar con CCBill. El formulario de pago acepta la información de pago del cliente, procesa el pago y devuelve al cliente a su sitio web donde se muestra un mensaje de confirmación.

CCBill proporciona dos tipos de formularios de facturación. FlexForms es nuestro sistema más nuevo (y recomendado), pero aún se admiten los formularios estándar. Elija un tipo de formulario y proceda de acuerdo con la sección paraOpción 1 or Opción 2, según su selección.

Opción 1: Creación de un nuevo formulario de pago FlexForms

Para crear un formulario FlexForm para usar con X-Cart:

1. Asegúrese Todas se selecciona en la parte superior Cuenta cliente Menú desplegable. Los FlexForms no son específicos de las subcuentas y no se pueden administrar cuando se selecciona una subcuenta.

2. Navegue hasta el Sistemas FlexForms pestaña en la barra de menú superior y seleccione Enlaces de pago de FlexForms. Todos los formularios existentes se mostrarán en una tabla.

Cree una URL de aprobación

1. Haga clic en el Biblioteca de URL en la esquina superior derecha para crear una nueva URL. Aparecerá el cuadro de diálogo Editor de URL guardadas.

2. Utilice los campos debajo Añadir nuevo para crear una nueva URL con las siguientes propiedades.

  • Nombre URL. Ingrese un nombre significativo para esta URL (por ejemplo, Pago exitoso).
  • Enlance. En URL, ingrese la URL base para su tienda X-Cart, seguida de:
/cart.php?target=payment_return&txn_id_name=cart_order_id&action=Approval_Post

Por ejemplo, si su tienda X-Cart se encuentra en http://www.test.com, el URL de aprobación sería:

http://www.test.com/cart.php?target=payment_return&txn_id_name=cart_order_id&action=Approval_Post

3. Hacer clic en Guardar para confirmar sus cambios. Su nueva URL se muestra debajo Lista existente.

Una lista de las URL de FlexForm existentes.

4. Haga clic en el signo más (+) símbolo debajo Pares de nombre / valor en la columna SANDBOX.

5. Debajo Tu parámetro (clave), ingrese: comerciante_order_id

6. Debajo Usa este método, Seleccione: Parámetro de paso del comerciante

7. En la tercera columna, ingrese: comerciante_order_id

8. Debajo Acción, haga clic en el Añada para guardar este parámetro. Sus parámetros guardados se muestran en Pares de nombre / valor definidos actualmente.

Agregue pares de valores de nombre CCBill FlexForms.

9. Cierra el Parámetros de nombre / valor editor para volver al editor de URL guardadas. Su nueva URL se muestra en la lista existente.

10. Hacer clic en Promover bajo el Acciones columna. Su URL ahora está activa.

11. Cierra el URL guardadas editor para volver al menú principal de FlexForms.

Cree un nuevo FlexForm

1. Haga clic en el Añadir nuevo en la parte superior izquierda para crear un nuevo formulario.

2. los Nuevo formulario se muestra el cuadro de diálogo:

  • Nombre del flujo de pago. En la parte superior, ingrese un nombre para el nuevo flujo de pago (este será diferente al nombre del formulario, ya que un solo formulario se puede utilizar en varios flujos).
  • Nombre del formulario. En Nombre del formulario, ingrese un nombre para el formulario.
  • fijación de precios dinámicos. En Precios, marque la casilla para habilitar los precios dinámicos.
  • Disposición. Seleccione el diseño que desee y guarde el formulario.
  • Editar el flujo. Haga clic en el botón de flecha a la izquierda de su nuevo flujo para ver los detalles. Bajo el verde Aprobar flecha, haga clic en el cuadrado para modificar la acción.
  • URL de aprobación. En el menú de la izquierda, seleccione Una URL > Seleccione una URL guardada y seleccione la URL que creó anteriormente (por ejemplo, Pago exitoso).
  • Tiempo de redireccionamiento. Seleccione un tiempo de redireccionamiento de 1 segundo usando el control deslizante en la parte inferior y guarde el formulario.

3. Promocionar para vivir. Haga clic en el Promocionar para vivir para habilitar su nuevo formulario para aceptar pagos.

4. Tenga en cuenta el Flex ID. Tome nota de la ID de Flex; este valor se ingresará en el nombre del formulario al completar la configuración en X-Cart.

Continúe con el Publicación de fondo para X-Cart sección de este documento.

Opción 2: Creación de un nuevo formulario de pago estándar

Para crear un formulario de facturación estándar para usar con X-Cart:

1. Inicie sesión en Portal de administración, y navega hacia el Administrador de formularios. Todos los formularios existentes se mostrarán en una tabla.

2. Hacer clic en Crear formulario nuevo en el menú de la izquierda para crear su nuevo formulario.

3. Seleccione la opción adecuada en Tipo de facturación. (En la mayoría de los casos, esto será Tarjeta De Crédito.)

4. Seleccionar Estándar bajo Tipo de formulario, a menos que tenga la intención de personalizar su formulario.

Pasos para crear un nuevo formulario estándar en el administrador de CCBill.

5. Elija un diseño y haga clic en Enviar al final de la página.

Su nuevo formulario ha sido creado y está visible en la tabla debajo Ver todos los formularios. En este ejemplo, nuestro nuevo formulario se llama 201cc.

Una lista de disponibles en CCBill Admin.

Configuración del nuevo formulario de facturación estándar

1. Haga clic en el título del formulario recién creado para editarlo.

2. Seleccionar Básico desde el menú de la izquierda.

3. Configure las siguientes opciones:

NOMBRE DEL CAMPOVALOR
Nombre del sitioIngrese la URL de su tienda X-Cart.
URL de aprobaciónhttp://www.yourx-cartstore.com/cart.php?target=order&order_number=%%merchant_order_id%%&Action=CheckoutSuccess
URL de denegaciónhttp://www.yourx-cartstore.com/cart.php?target=order&order_number=%%merchant_order_id%%&Action=CheckoutFailure
Tiempo de redireccionamientoSeleccione un tiempo de redireccionamiento de aprobación de 3 segundos y un tiempo de redireccionamiento de denegación de Ninguna.

Publicación de fondo para X-Cart

En su interfaz de administración de CCBill seleccionar una subcuenta las compras se realizarán y navegará a Información de cuenta -> Administrador de subcuenta y seleccionar Avanzado desde el menú de la izquierda.

Observe la sección superior titulada Información de la publicación de antecedentes. Estaremos modificando el URL de publicación de aprobación y URL de publicación de denegación campos.

URL de publicación de aprobaciónhttp://www.yourx-cartstore.com/cart.php?target=payment_return&txn_id_name=cart_order_id&action=Approval_Post
URL de publicación de denegaciónhttp://www.yourx-cartstore.com/cart.php?target=payment_return&txn_id_name=cart_order_id&action=Denial_Post

Su cuenta CCBill ahora está configurada. En la interfaz de administración de CCBill, navegue hasta Administrador de subcuenta y asegúrese de que la información mostrada sea correcta.

Configuración - X-Cart

Opciones generales

1. Seleccionar Configuración de la tienda en el menú de la izquierda y seleccione Métodos De Pago.

2. Haga clic en el botón en la parte superior para agregar un método de pago.

3. Localizar Pagos CCBill en la lista y haga clic Añada.

Configure el módulo CCBill en X-Cart.

4. Ingrese la información de su cuenta CCBill. Consulte los detalles de los campos individuales a continuación.

OPCIÓNDESCRIPCIÓN
Número de cuenta del clienteIngrese su número de cuenta de cliente CCBill.
Número de subcuenta del clienteIngrese su número de subcuenta de cliente de CCBill.
Nombre del formularioIngrese el nombre del formulario creado durante la configuración de la cuenta CCBill, o el ID de FlexForm si usa FlexForms.
Es Flex FormSeleccione si usa FlexForms.
MonedaSeleccione la moneda de facturación. Asegúrese de que esta selección coincida con la selección realizada en el Configuración de la tienda -> Localización -> Divisas sección del menú de administración de X-Cart.
SalIngrese su clave de encriptación / sal obtenida durante la configuración de CCBill.

5. Hacer clic en Guardar los cambios en la parte inferior de la sección de configuración de CCBill.

Guarde la configuración del módulo CCBill en X-Cart.

6. El sistema le redirige a la lista de métodos de pago y Pagos CCBill debe marcarse como activo. Si no es así, haga clic en el activo inactivo cambie para marcarlo como activo.

Active el módulo de pago CCBill en el administrador de X-Cart.

¡Ahora está listo para procesar pagos a través de CCBill! Realice algunas transacciones de prueba (utilizando los datos de prueba proporcionados por CCBill) para garantizar un funcionamiento adecuado antes de habilitar el modo de facturación en vivo en su cuenta de CCBill.