Bienvenido al respositorio de Culqi Integración para WordPress. Este plugin te permite sincronizar tus pagos, tus ordenes y tus clientes desde Culqi; y además, mediante WooCommerce puedes realizar pagos simples de una manera segura.

• Version PHP mínimo requerido es 7.4
• Credenciales de Culqi

Puedes descargar el plugin desde el repositorio de WordPress : https://wordpress.org/plugins/culqi-full-integration/

O puedes instalarlo desde el mismo WordPress. Ir a Plugins > Agregar nuevo

Buscar "Culqi", instalar y activar

1. Clonar Repositorio git clone git@github.com:LetsGoDev-com/culqi-full-integration.git

2. Descargar dependencias composer update

Debes registrarte en https://www.culqi.com y luego acceder al panel de integración. Una vez ahi, irás a Desarrollo > ApiKey y así obtendrás tus credenciales:

Cuando actives el plugin, éste te redireccionará a una página de bienvenida donde deberás poner tus credenciales de Culqi y otras cosas más.

Una vez llenado todo correctamente, al presionar "Guardar", éste le enviará a la página de configuración del plugin.

El plugin registrará a los clientes en Culqi sólo si el comprador esta logueado en la tienda.

Tienes activada la pasarela de pago para WooCommerce y sólo debes ir a personalizarlo.

El log siempre está habilitado, cada pedido tendrá un detalle de todos los pasos que sigue Culqi para hacer el pago. Aqui también se registrará los errores si los hay.

Tenemos resumenes para el pago y para multipago en el detalle del pedido de WooCommerce

Culqi recomienda que estos campos sean obligatorios:

• Email
• Nombre
• Apellido
• Dirección
• Ciudad
• Código de pais ( ejem: para Perú es PE)
• Teléfono

De todos estos puntos el más importante es el email, los otros campos son muy necesarios para un tema de antifraude pero no son obligatorios. Yo recomiendo que tengas todos estos campos en tu checkout. El plugin no validará estos campos.

Podrás hacer reembolsos usando la API de Culqi con un sólo click, además de reponer el stock si así lo especificas.

Puedes habilitar Multipagos en la sección de configuración de la pasarela de pago Culqi. Cada vez que se genera una orden de pago, le llegará al cliente un email con el CIP de pago.

Cuando el cliente page su código CIP, Culqi avisará al comercio mediante un evento el cual debemos configurar: para ello, debemos entrar al panel de Culqi e ir a la sección de eventos y al submenu de webhooks. Finalmente le damos click al botón Añadir que está arriba a la derecha.

Debes elegir el evento : order.status.changed y la URL que debes poner está en la sección Webhooks del plugin.

https://{tuweb}/fullculqi-api/webhooks

Aún no es compatible, pero estamos trabajando para que lo sea.

El servicio de Culqi suele ser óptimo cuando se trata de registrar pagos simples pero, raras veces, cuando empiezas a interactuar con otros servicios puede traernos estos tipos de problemas, si sueles tener alguno, comunicate con ellos.

• Ups! Algo salió mal en Culqi. Contáctate con soporte@culqi.com para obtener mas información - El servicio de Culqi, para el servicio solicitado, no está disponible en ese momento

• Endpoint request timed out - El endpoint del API de Culqi a agotado su tiempo de solicitud

Para hacer una verificación del servicio de Culqi, te invito a seguir esta guía simple y sencilla. Sólo te tomará 10 minutos.