culqi / culqi-prestashop Goto Github PK

Módulo PrestaShop de Culqi.

License: MIT License

PHP 55.01% Smarty 41.95% CSS 0.44% HTML 2.35% JavaScript 0.25%

culqi-prestashop's Introduction

Plugin - Prestashop 1.6

Nuestro plugin integra por tí nuestro Checkout v4 y nuestra librería JS 3DS, con los cuales tendrás la posibilidad de realizar cobros con tarjetas de débito y crédito, Yape, PagoEfectivo, billeteras móviles y Cuotéalo con solo unos simples pasos de configuración.

Recuerda que para usar cualquier plugins necesitas tener tu llave pública y llave privada (test o live), los cuales los puedes generar a través de tu Culqipanel.

Requisitos

PHP 7.0+
Prestashop 1.6.0+
Credenciales de Culqi

Instalación y activación

Descargar el zip (.zip) de nuestro plugin desde aquí y subirlo como un módulo.

Luego busca el plugin instalado con el nombre de Culqi y procedes a activarlo.

Configuración

A continuación se presenta una imagen de la pantalla de configuración:

Ingresa en la sección "Settings" para configurar el plugin. Independiente del mecanismo de instalación, los pasos para configurar el plugin son los mismos.

Activa tu Culqi checkout: Siempre debes mantenerlo activo para que tu checkout se muestre en tu tienda virtual.
Selecciona el ambiente (integración o producción): Este paso es esencial para que determines cuándo realizar pruebas y cuándo activar tu tienda en producción. Sirve también para indicar en que ambiente de CulqiPanel vas iniciar sesión.
Iniciar sesión: Con este boton podrás iniciar sesión en tu CulqiPanel y podrás obtener las llaves de tu comercio automáticamente.

Recuerda que las credenciales son enviadas al correo que registraste en el proceso de afiliación.

Ingresa las llaves pública y privada (test o live): Lo puedes hacer de manera manual o automática. Para el segundo, haz click en "Iniciar Sesión" para entrar al CulqiPanel, luego selecciona tu comercio e inserta automáticamente tus llaves.

Recuerda que las llaves de integración se identifican como "test" y las de producción como "live".

Selecciona los métodos de pago: Por defecto nuestro plugin habilita los pagos con tarjeta. Sin embargo, si deseas habilitar otros medios de pago (Banca móvil e internet, Agentes y bodegas, Billeteras móviles, Cuotéalo BCP) solo debes activar los "checks".
Define el tiempo de expiración de pago: Debes definirlo si habilitarás pagos con PagoEfectivo, billeteras móviles o Cuotéalo.

Recuerda que si no configuras el tiempo de expiración, este tomará el tiempo por defecto: 24 horas.

Registra notificaciones de pago (Webhook): Valida en tu CulqiPanel que la URL de notificaciones de pago sea correcta.

Recuerda que si no iniciaste sesión en el Culqipanel desde el plugin, debes configurar manualmente la URL de Webhook con el evento (order.status.changed). Sigue los pasos aquí.

Personaliza tu checkout: Con esta opción puedes cambiar los colores preestablecidos por los colores de tu marca, así como el logo.

Finalmente guarda tu configuración: ¡Listo!, Tus clientes ya pueden realizar pagos a través de tu tienda virtual.

Pruebas

Antes de activar tu tienda en producción, te recomendamos realizar pruebas de integración. Así garantizarás un correcto despliegue.

Si vas a empezar a vender desde tu tienda virtual, deberás seleccionar el ambiente de producción e ingresar tus llaves.

Recuerda que si quieres probar tu integración, puedes utilizar nuestras tarjetas de prueba.

Versiones disponibles

Contamos con las siguientes versiones:

	Versión	Descarga
	1.6.0+	Descargar

Manual de instalación y configuración

Puedes usar el manual para obtener más detalle:

	Descarga
	Descargar

culqi-prestashop's People

Contributors

Stargazers

Watchers

Forkers

drihu soporte-culqi lizruelas cloyola brayancruces johnulist ikcam raphaelts3 cmeza20 nicerova7 jordandiaz2022

culqi-prestashop's Issues

Agregar sección de Licencia al Readme

Agregar la sección de Licencia al Readme.md

ContextErrorException in CustomerFormatter.php line 215:

Hola. No soy desarrollador, pero intuyo a grandes rasgos algunas cosas. He montado una tienda en prestashop 1.7.1.1. La tienda es www.maqorito.com
He tomado la última actualización del plug in 3.02 y he seguido los pasos para incluir el campo teléfono como obligatorio, sin embargo tengo problemas, sea con cuenta invitado o para crear una nueva cuenta. Por el mensaje, entiendo que es algo relacionado con el formato de cliente, en la línea 215 del archivo php. Si intento hacer un pago de una compra como invitado, el proceso de checkout se corta antes de completar el formulario de dirección, arrojando las siguientes 10 líneas de error (he activado el depurador de prestashop para obtener el mensaje):

ContextErrorException in CustomerFormatter.php line 215:
Warning: Invalid argument supplied for foreach()
in CustomerFormatter.php line 215
at ErrorHandler->handleError('2', 'Invalid argument supplied for foreach()', '/home/romy1976/public_html/classes/form/CustomerFormatter.php', '215', array('format' => array('id_customer' => object(FormField), 'id_gender' => object(FormField), 'firstname' => object(FormField), 'lastname' => object(FormField), 'email' => object(FormField), 'password' => object(FormField), 'birthday' => object(FormField), 'optin' => object(FormField), 'ps_emailsubscription_newsletter' => object(FormField)), 'genderField' => object(FormField), 'gender' => object(Gender), 'additionalCustomerFormFields' => array('ps_emailsubscription' => array(object(FormField)), 'an_staticblocks' => ''), 'moduleName' => 'an_staticblocks', 'additionnalFormFields' => '', 'formField' => object(FormField))) in CustomerFormatter.php line 215
at CustomerFormatterCore->getFormat() in AbstractForm.php line 153
at AbstractFormCore->fillWith(array('id' => null, 'id_shop' => null, 'id_shop_group' => null, 'secure_key' => null, 'note' => null, 'id_gender' => '0', 'id_default_group' => '1', 'id_lang' => null, 'lastname' => null, 'firstname' => null, 'birthday' => null, 'email' => null, 'newsletter' => null, 'ip_registration_newsletter' => null, 'newsletter_date_add' => null, 'optin' => null, 'website' => null, 'company' => null, 'siret' => null, 'ape' => null, 'outstanding_allow_amount' => '0', 'show_public_prices' => '0', 'id_risk' => null, 'max_payment_days' => '0', 'passwd' => null, 'last_passwd_gen' => null, 'active' => true, 'is_guest' => '0', 'deleted' => '0', 'date_add' => null, 'date_upd' => null, 'years' => null, 'days' => null, 'months' => null, 'geoloc_id_country' => null, 'geoloc_id_state' => null, 'geoloc_postcode' => null, 'logged' => '0', 'id_guest' => '4717', 'groupBox' => null, 'reset_password_token' => null, 'reset_password_validity' => null, 'id_shop_list' => null, 'force_id' => false, 'id_customer' => null)) in CustomerForm.php line 76
at CustomerFormCore->fillFromCustomer(object(Customer)) in CheckoutPersonalInformationStep.php line 60
at CheckoutPersonalInformationStepCore->handleRequest(array('controller' => 'order')) in CheckoutProcess.php line 57
at CheckoutProcessCore->handleRequest(array('controller' => 'order')) in OrderController.php line 202
at OrderControllerCore->initContent() in Controller.php line 205
at ControllerCore->run() in Dispatcher.php line 369
at DispatcherCore->dispatch() in index.php line 28

Si por el contrario intento crear una nueva cuenta para poder comprar, también obtengo un error, pero de solo 7 líneas. Su ayuda por favor. Es un error de configuración de mi parte o se trata de otro problema.

index.php?controller=order:809 Uncaught TypeError: Cannot read property 'user_message' of undefined

Hola,

Nuevo problemita, cuando selectiono otro metodo de pago (i.e. tranferencia bancaria) tengo el error siguiente en la consola javaScript y no puedo procesar el pago :

index.php?controller=order:809 Uncaught TypeError: Cannot read property 'user_message' of undefined
    at charge (index.php?controller=order:809)
    at HTMLButtonElement.<anonymous> (index.php?controller=order:759)
    at HTMLButtonElement.dispatch (bottom-076ab9.js:100)
    at HTMLButtonElement.elemData.handle (bottom-076ab9.js:92)
charge @ index.php?controller=order:809
(anonymous) @ index.php?controller=order:759
dispatch @ bottom-076ab9.js:100
elemData.handle @ bottom-076ab9.js:92

Cuando miro al dicho archivo, parece que el error esta en esta linea :

showResult('red',Culqi.error.user_message);

pues parece que el objeto Culqi.error no esta definido...

Solve prestashop validation issues

You don't need solve all issues, if you can solve just one, you can send us a PR 👍

Report: https://gist.github.com/joelibaceta/d38241814e93aa2a1f12c46f585cc13e

Error JavaScript Uncaught TypeError:

Hola, estoy teniendo estos errores en javascript en 2 webs.

Caso 1: Llega hasta la ventana de confirmación de pago, ingreso los datos de la tarjeta de prueba y me lanza estos errores.
1512027697395.log

Caso 2: En la pagina del carrito, elijo el medio de pago y la página se queda en blanco. Estos son los errores que aparecen en el log de Chrome.
1512028089070.log

Hubo algunos problemas al intentar validar tu compra. Contáctanos para ayudarte.

Y aparte en el inspeccionador me muestra el mensaje Config: undefined .

Adjunto las imagenes del error para mayor conocimiento:

Add support to Prestashop 1.7

follow the following links:

http://developers.prestashop.com/module/50-PaymentModules/index.html

http://build.prestashop.com/news/prestashop-1-7-faq/

Numero de telefono obligatorio

Hola Chicos,

Gracias por este sistema y su integración super facil !

Estoy probando la integración de Culqi con nuestra tienda prestashop 1.7.

Algunas Mejoras sugeridas :

El número de teléfono es un campo obligatorio de su API pero no del Prestashop... Lo puedo cambiar en la configuración de prestashop. Para que el número de teléfono es necesario ?
Si el número de teléfono es obligatorio y que el cliente no lo entro, seria bueno tener un mensaje de error mas explicite... tuve que abrir la consola y los logs de la API para entender lo que había pasado.
Al proceder el pago tuve algunas errores en la consola 'culqi is not defined'.