Módulo CCBill osCommerce
Introducción
El objetivo de este documento es proporcionar instrucciones de instalación y configuración para el módulo de facturación CCBill osCommerce. Este documento asume que el lector tiene un conocimiento práctico de osCommerce y ya ha instalado el software osCommerce.
La instalación consta de los siguientes pasos:
- Instalación del módulo de pago CCBill para osCommerce.
- Configurando su cuenta CCBill para usar con osCommerce.
- Configurar el módulo con la información de su cuenta CCBill.
Instalación
El módulo CCBill osCommerce se instala cargando el código del complemento descargado del sitio web CCBill en las carpetas correspondientes en su instalación de osCommerce. Hay cinco (5) archivos que deben copiarse:
- /ext/modules/pago/ccbill/ccbill_post_handler.php
- /ext/modules/pago/ccbill/ccbill_process_success.php
- /incluye/idiomas/inglés/módulos/pago/ccbill.php
- /incluye/modulos/pago/ccbill.php
- /ccbill_post_handler.php
Antes de la instalación, si tiene la versión anterior de la pasarela de pago CCBill, elimínela del administrador de osCommerce y luego cargue el nuevo código.
1. En el menú de la izquierda de la interfaz de administración de osCommerce, seleccione Módulos > Pago.
2. Hacer clic en Instalar módulo.
3. Seleccionar Pagos CCBill de la lista y haga clic Instalar módulo.
Una vez que el módulo se haya instalado correctamente, será redirigido a Módulos de las Pago sección de la interfaz de administración, con el nuevo módulo CCBill seleccionado.
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 .
Creación de una clave de cifrado / sal
Una "sal" es una cadena de datos aleatorios que se utiliza para hacer que su encriptación sea más segura. Debe ponerse en contacto con CCBill Merchant Support para generar su Sal/Clave de cifrado. Una vez configurado, será visible debajo del 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 .
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. Atravez de 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 existentes Configuración de nombre de usuario .
Creación de un nuevo formulario de pago
Los formularios de pago se muestran a los clientes después de que eligen pagar. El formulario de pago acepta la información de pago del cliente, procesa el pago y devuelve al cliente a su tienda osCommerce donde se muestra un mensaje de confirmación.
CCBill proporciona dos tipos de formularios de facturación. Formularios flexibles 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 para Opció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 osCommerce:
1. Asegúrese Todos 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 de su tienda osCommerce, seguida de:
/ext/modules/payment/ccbill/ccbill_post_handler.php?Action=Approval_PostPor ejemplo, si su tienda osCommerce se encuentra en http://www.test.com, el URL de aprobación sería:
http://www.test.com/ext/modules/payment/ccbill/ccbill_post_handler.php?Action=Approval_Post3. Hacer clic en Guardar para confirmar sus cambios. Su nueva URL se muestra debajo Lista existente.
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: id_pedido_zc
6. Debajo Usa este método, Seleccione: Parámetro de paso del comerciante
7. En la tercera columna, ingrese: id_pedido_zc
8. Debajo la columna 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.
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 Promocionar para vivir para habilitar su nuevo formulario para aceptar pagos.
4. Tenga en cuenta el Flex ID. Anote el Flex ID; este valor se ingresará en el nombre del formulario al completar la configuración en DatingPro.
Su configuración de CCBill FlexForms ahora está completa. Pase directamente a la sección titulada Publicación de fondo para osCommerce.
Opción 2: Creación de un nuevo formulario de pago estándar
Para crear un formulario de facturación para usar con osCommerce:
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.
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.
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 Basic desde el menú de la izquierda.
3. Configure las siguientes opciones:
| NOMBRE DEL CAMPO | VALOR |
|---|---|
| Nombre del sitio | Ingrese la URL de su tienda osCommerce. |
| URL de aprobación | http://www.youroscommercestore.com/ext/modules/payment/ccbill/ccbill_process_success.php |
| URL de denegación | http://www.youroscommercestore.com/checkout_payment.php |
| Tiempo de redireccionamiento | Seleccione un tiempo de redireccionamiento de aprobación de 3 segundos, y un tiempo de redireccionamiento de denegación de Ninguna. |
Publicación de antecedentes para osCommerce
Mientras todavía en el Administrador de subcuenta sección, seleccionar Avanzado en 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ón | http://www.youroscommercestore.com/ext/modules/payment/ccbill/ccbill_post_handler.php?Action=Approval_Post |
| URL de publicación de denegación | http://www.youroscommercestore.com/ext/modules/payment/ccbill/ccbill_post_handler.php?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 - osCommerce
En el menú de la izquierda de la interfaz de administración de osCommerce, navegue hasta Módulos > PagoY seleccione Pagos CCBill. Las opciones se muestran a la derecha y al hacer clic Editar hace que las opciones sean editables.
Ingrese la información de su cuenta CCBill. Consulte los detalles de los campos individuales a continuación.
| NOMBRE DEL CAMPO | VALOR |
|---|---|
| Habilitar CCBill | Marque la casilla superior para habilitar los pagos con el estándar CCBill. |
| Número de cuenta del cliente | Ingrese su número de cuenta de cliente CCBill. |
| Número de subcuenta del cliente | Ingrese su número de subcuenta de cliente de CCBill. |
| Nombre del formulario | Ingrese el nombre del formulario creado durante la configuración de la cuenta CCBill, o el ID de FlexForm si usa FlexForms. |
| Es Flex Form | Seleccione Sí si usa FlexForms. |
| Moneda | Seleccione la moneda de facturación. Asegúrese de que esta selección coincida con la selección realizada en el Localización -> Monedas sección del menú de administración de osCommerce. |
| Sal | Ingrese su clave de encriptación / sal obtenida durante la configuración de CCBill. |
| Estado del pedido | Seleccione el estado que se le dará a los pedidos una vez que se haya completado el pago. |
under Moneda de transacción, ingrese el valor del código de moneda de tres (3) dígitos para la moneda que desea que se muestre a sus compradores. CCBill admite actualmente las siguientes monedas:
| MONEDA | CÓDIGO |
|---|---|
| Dólar EE.UU. (USD) | 840 |
| Euro (EUR) | 978 |
| Dólar australiano (AUD) | 036 |
| Dólar canadiense (CAD) | 124 |
| Libras esterlinas de Gran Bretaña (GBP) | 826 |
| Yen japonés (JPY) | 392 |
Haga Clic en Guardar en la parte inferior de la sección de configuración de CCBill. ¡Ahora está listo para procesar pagos a través de CCBill!
Por favor, realizar algunas transacciones de prueba (utilizando 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.