Configuración del complemento WooCommerce para pagos de 4Geeks¶
Descripción general¶
El Complemento WooCommerce de 4Geeks Payments le permite aceptar pagos en línea en su tienda WordPress/WooCommerce en 5 minutos o menos, sin necesidad de codificación. Como comerciante registrado, 4Geeks se encarga del cumplimiento tributario, la prevención del fraude y las devoluciones de cargos para que usted pueda concentrarse en vender.
En este tutorial, podrás:
- Instale el complemento de pagos 4Geeks
- Configurar métodos de pago
- Probar transacciones en modo sandbox
- Comienza a funcionar y comienza a aceptar pagos.
Requisitos previos¶
- Una cuenta de 4Geeks Payments activada (activar servicio)
- WordPress 5.0+ con WooCommerce instalado
- Acceso de administrador a su panel de WordPress
Paso 1: instalar el complemento¶
Opción A: desde el directorio de complementos de WordPress¶
- Vaya a su panel de administración de WordPress
- Vaya a Complementos → Agregar nuevo
- Busque “Pagos 4Geeks”
- Haga clic en “Instalar ahora” y luego en “Activar”
Opción B: Carga manual¶
- Descargue el complemento desde docs.4geeks.io/en/paids/plugins/woocommerce
- Vaya a Complementos → Agregar nuevo → Cargar complemento
- Sube el archivo ZIP
- Haga clic en “Activar”
Paso 2: Configurar claves API¶
- Vaya a WooCommerce → Configuración → Pagos
- Busque 4Geeks Payments y haga clic en “Administrar”
- Ingrese sus credenciales API:
- Clave pública: Desde tu consola 4Geeks
- Clave secreta: Desde tu consola 4Geeks
- Cambie “Activar/Desactivar” a Activar
Consejo: Comience con las claves de la zona de pruebas para probarlas antes de publicarlas.
Paso 3: Configurar los ajustes de pago¶
Configuración general¶
| Configuración | Descripción | Recomendado |
|---|---|---|
| Título | Nombre del método de pago que se muestra al finalizar la compra | “Tarjeta de crédito/débito” |
| Descripción | Descripción mostrada a los clientes | “Paga de forma segura con tu tarjeta” |
| Modo de prueba | Habilitar pruebas de espacio aislado | Sí (inicialmente) |
| 3D seguro | Habilitar la autenticación 3DS | Sí |
Configuración de transacciones¶
| Configuración | Descripción | Recomendado |
|---|---|---|
| Captura | Captura automática o autorización únicamente | Captura automática |
| Descriptor de declaración | Texto en el extracto bancario del cliente | El nombre de tu empresa |
| Tarjetas aceptadas | Qué marcas de tarjetas aceptar | Todo habilitado |
Paso 4: Prueba en modo Sandbox¶
- Asegúrese de que Modo de prueba esté habilitado
- Agregue un producto a su carrito y proceda al pago
- Utilice un número de tarjeta de prueba:
| Tarjeta | Número | Resultado |
|---|---|---|
| Visa (Éxito) | 4242 4242 4242 4242 | Pago aprobado |
| Visa (Rechazada) | 4000 0000 0000 9995 | Pago rechazado |
| Requiere 3DS | 4000 0000 0000 0002 | Desafío 3D Seguro |
- Utilice cualquier fecha de vencimiento futura y cualquier CVC de 3 dígitos
- Complete el pago y verifique el estado del pedido.
Paso 5: Verificar la configuración del webhook¶
Los webhooks garantizan que su tienda reciba actualizaciones de pagos en tiempo real:
- En tu consola 4Geeks, ve a Pagos → Configuración → Webhooks
- Agregue la URL de su webhook:
https://yourstore.com/wc-api/4geeks_paids - Seleccione eventos para recibir:
carga.exitosacarga.fallidareembolso.completadosuscripción.creada- Guarde y pruebe el webhook.
Paso 6: Transmitir en vivo¶
Una vez completada la prueba:
- Cambie de Modo de prueba a Modo en vivo en la configuración del complemento
- Reemplace las claves API de sandbox con claves de producción
- Realice un pedido de prueba real con una tarjeta real (pequeña cantidad)
- Verifica que el pago aparezca en tu consola 4Geeks
- Confirme que el pago esté programado en su cuenta bancaria.
Funciones admitidas¶
| Característica | Apoyado |
|---|---|
| Pagos únicos | Sí |
| Suscripciones recurrentes (Suscripciones WooCommerce) | Sí |
| Reembolsos del administrador de WooCommerce | Sí |
| Reembolsos parciales | Sí |
| Multidivisa | Sí |
| 3D Seguro (3DS) | Sí |
| Tarjetas guardadas | Sí |
| Enlaces de pago | Sí |
Solución de problemas¶
Problemas comunes¶
| Problema | Solución |
|---|---|
| Error “Clave API no válida” | Verificar que las claves sean correctas y provengan del entorno correcto (sandbox versus producción) |
| El pago falla silenciosamente | Verifique la configuración del webhook y los registros del servidor |
| 3D Secure no se activa | Asegúrese de que 3DS esté habilitado en la configuración del complemento |
| Reembolso no procesado | Verifique que el cargo original sea capturado y reembolsable |
Obteniendo ayuda¶
- Verifique los registros del complemento: WooCommerce → Estado → Registros
- Revise la Documentación de pagos
- Póngase en contacto con el soporte a través del panel de la consola.
¿Qué sigue?¶
- Obtenga más información sobre Facturación de suscripción recurrente
- Explorar Pago multidivisa
¿Necesitas ayuda?¶
- Documentación: docs.4geeks.io/en/paids/plugins/woocommerce
- Referencia de API: docs.4geeks.io/en/api
- Soporte: disponible a través del panel de la consola
Aún con dudas? Pregunta en Discord o explore tutoriales