Autorización y Captura es un método de pago que permite autorizar el cobro de fondos al crear un pedido para capturar esos fondos una vez que el pedido ha sido procesado.
El principio es simple: cuando su cliente realiza un pedido, se crea una autorización de cobro que valida la transferencia de sus fondos durante 29 días. Durante estos 29 días, se garantiza un "período de validez" de los fondos durante los primeros 3 días. Al expirar los 3 días, puede renovar la validez de los fondos cada 3 días durante esos 29 días.
Una vez que el período de 29 días ha pasado, la autorización expira y el pedido se cancela.
| Al final del capítulo encontrará un glosario de los términos más utilizados para este método de pago. |
¿Por qué activar este flujo de pago?
Autorización y captura le permite:
- asegurar la transacción (la autorización garantiza la disponibilidad de los fondos).
- evitar cargos por ventas que no se realizan (sin cargos por cancelación).
- eliminar reembolsos en caso de pedidos no enviados.
- controlar su inventario vendiendo solo los artículos disponibles.
Compatibilidad de pagos
Autorización y Captura es compatible solo con estos métodos de pago:
- PayPal
- Tarjeta de crédito
- Apple Pay
- Google Pay.
Nota: La activación de Autorización y Captura desactiva automáticamente otros métodos de pago.
¿Cómo configurar Autorización y Captura?
Active este modo desde el menú de su back office: Pago > Métodos de pago y luego en la sección Módulos de pago activos, haga clic en el “CTA configurar” del módulo PrestaShop Checkout. Termine su configuración en la pestaña Configuración avanzada.
Nota: la activación desactiva automáticamente otros métodos de pago locales.
En la pestaña Configuración avanzada, active “Autorizar y Capturar” y luego seleccione su método de captura:
- Captura instantánea (por defecto): captura automáticamente los fondos en el momento del pago. Los fondos se cobrarán automáticamente cuando se registre el pedido.
- Captura automática por estado: puede elegir el/los estado(s) del pedido que activará(n) la captura automática de los fondos.
- Ejemplo: si elijo el estado “Enviado”, los fondos se capturarán cuando el estado del pedido sea “Enviado”.
Importante: Si no se selecciona ningún estado, el pedido se capturará en todos los estados por defecto.
¿Cómo gestionar las autorizaciones en los pedidos?
Desde su back-office en la sección “pedidos”, localice el pedido que desea capturar. Baje al recuadro dedicado al pago (ver abajo) para encontrar la lista de transacciones.
Al desplegar cada transacción, encontrará los detalles de cada una con su monto:
- Autorización pendiente
- Encontrará el período de autorización que le permite ver las fechas de creación de la autorización, la validez de la captura y su expiración.
- Pago
- Reembolsado parcialmente
- Reembolsado
Tiene 3 acciones; puede:
- autorizar nuevamente el período de validez de 3 días,
- capturar los fondos inmediatamente en el pedido,
- o cancelar la captura.
Para ello, puede ir al pedido sobre el que desea actuar, luego bajar a la lista de transacciones y desplegar los detalles de la transacción.
Hacer clic en Re-autorizar le permite extender el período de validez de 3 días durante el cual PayPal garantiza la disponibilidad de los fondos. Se abrirá una ventana de PayPal para confirmar la solicitud de re-autorización.
Hacer clic en Capturar le permite capturar los fondos inmediatamente. El pago será cobrado/efectuado en ese momento. Se abrirá una ventana de PayPal para confirmar la solicitud de captura.
Hacer clic en Cancelar le permite cancelar la autorización de la captura y devolverá los fondos a la cuenta del cliente. Se abrirá una ventana de PayPal para confirmar la cancelación.
Nota: una vez confirmada la cancelación, ya no podrá capturar el monto. El pedido queda definitivamente cancelado.
Próximamente: Pronto podrá capturar solo una parte del monto de un pedido. Para ser informado en cuanto esta funcionalidad esté disponible, contáctenos en: pscheckout@prestashop.com
¿Qué hacer si la captura falla?
Se mostrará un mensaje de error en su back-office. Si su mensaje se refiere a:
- Un error técnico: intente capturar nuevamente más tarde. Si el error persiste, puede contactar nuestro centro de ayuda a través de este formulario.
- Un fallo en el pago (debido a un método de pago rechazado): la captura es imposible y el pedido se cancela. Para reclamar el pago al cliente, cree un enlace de pago desde el panel de PayPal mediante Request Money.
¿Cómo realizar un reembolso?
Desde el pedido correspondiente, diríjase al final de la página en la lista de transacciones y haga clic en “Reembolso”. Se abrirá una ventana de PayPal. Ingrese el monto a reembolsar y confirme. Aparecerá un mensaje de confirmación en su pantalla.
Nota: el reembolso solo es posible si la transacción está en estado “completado” o “reembolso parcial”.
Algunas buenas prácticas
Gestión del período de garantía
- Para beneficiarse del período de garantía, recuerde capturar sus fondos en los primeros 3 días.
- ¿No capturó sus fondos en los primeros 3 días? Renueve la autorización para 3 días adicionales.
- Controle las fechas de expiración (máximo 29 días) para evitar la pérdida de autorización.
¿Gestión de estados “pendiente” (pending)?
- Una autorización PENDING/PENDIENTE generalmente se resuelve en 24 a 72 horas.
- Después de 72 horas, considere la autorización como rechazada y contacte al cliente.
- No espere 29 días para resolver un estado PENDING/PENDIENTE.
Comunicación con el cliente
- Informe a sus clientes que el pago solo se debitará al envío, no en el momento del pedido. (enlace a la configuración de correos o al menos indicarlo).
- Explique que verán una "retención" en su cuenta pero no un débito inmediato.
- Avíseles en caso de modificación del monto antes de la captura final.
Detalles de los diferentes estados
Las diferentes tablas le proporcionan la información necesaria sobre los estados para entender y seguir el progreso de un pago paso a paso.
Detalles de estados relacionados con un pedido
| Valor (Enum) | Descripción |
|---|---|
| CREATED | El pedido ha sido creado con el contexto especificado. |
| APPROVED | El cliente ha aprobado el pago a través de su cartera PayPal u otra forma de pago (tarjeta, cuenta bancaria, etc.). |
| VOIDED | Todas las unidades de compra del pedido han sido anuladas. |
| COMPLETED | La intención del pedido ha sido finalizada y se ha creado un recurso de pago. Importante: Verifique el estado del pago en purchase_units[].payments.captures[].status antes de procesar el pedido. |
Detalles de estados relacionados con una autorización
| Valor (Enum) | Descripción |
|---|---|
| CREATED | La autorización está pendiente de revisión manual. |
| CAPTURED | El pago ha sido capturado con éxito. |
| DENIED | PayPal no puede autorizar los fondos para este pago. |
| PARTIALLY_CAPTURED | Se ha realizado un pago parcial por un monto inferior a la autorización inicial. |
| VOIDED | La autorización ha sido anulada. No se puede realizar ninguna captura sobre esta autorización. |
| PENDING | La autorización está pendiente. Consulte status.details para más información. |
Detalles de estados relacionados con una captura
| Valor (Enum) | Descripción |
|---|---|
| COMPLETED | Los fondos han sido acreditados en la cuenta PayPal del beneficiario. |
| DECLINED | No se pudieron capturar los fondos. |
| PARTIALLY_REFUNDED | Se ha reembolsado al pagador un monto inferior al total de la captura. |
| PENDING | Los fondos aún no han sido acreditados. Consulte status.details para más detalles. |
| REFUNDED | Se ha reembolsado al pagador un monto igual o superior al monto capturado. |
| FAILED | Se produjo un error durante la captura del pago. |
Detalles de estados relacionados con los reembolsos
| Valor (Enum) | Descripción |
|---|---|
| CANCELLED | El reembolso ha sido cancelado. |
| FAILED | El reembolso no pudo ser procesado. |
| PENDING | El reembolso está pendiente. Consulte status_details.reason. |
| COMPLETED | Los fondos han sido debitados y devueltos al cliente. |
Gestión de errores en operaciones automáticas
En caso de problema en una transacción, se muestra un mensaje de error en la parte superior de su pantalla y el estado del pedido se actualiza automáticamente:
- Error de pago: este estado se aplica si la autorización o la captura es imposible. Si el rechazo ocurre durante la captura, le aconsejamos contactar al cliente (verificación de fondos o validez de la tarjeta).
- Autorización expirada: este estado indica que el plazo de validez de la autorización ha sido superado y los fondos ya no están reservados.
Gestión de errores en operaciones manuales
Si una acción manual falla, se muestra un mensaje de error detallado en pantalla para guiarle directamente. Esto puede ocurrir en las siguientes operaciones:
- Captura: Imposible validar el cobro.
- Re-autorización: Fallo al renovar la validez del pago.
- Cancelación: Imposible cancelar la autorización en curso.
- Reembolso: Fallo al devolver los fondos al cliente.
Esta funcionalidad le ofrece una gestión de pagos flexible y adaptada a las restricciones logísticas y comerciales de su actividad, asegurando las transacciones para usted y sus clientes.
Gestión de webhooks
Para gestionar eficazmente los diferentes webhooks relacionados con PayPal, aquí tiene una tabla resumen de los diferentes eventos:
| Eventos Webhooks | Descripción |
|---|---|
PAYMENT.AUTHORIZATION.CREATED |
Se crea la autorización. Los fondos quedan bloqueados en la cuenta del cliente. |
PAYMENT.CAPTURE.COMPLETED |
La captura fue exitosa. El dinero se transfiere a su cuenta PayPal. |
PAYMENT.CAPTURE.DENIED |
La captura fue rechazada (ej: fondos insuficientes en el momento final). |
PAYMENT.AUTHORIZATION.VOIDED |
La autorización ha sido anulada o ha expirado (plazo excedido). |
PAYMENT.CAPTURE.REFUNDED |
Se ha realizado un reembolso sobre esta transacción. |
PAYMENT.CAPTURE.REVERSED |
PayPal ha revertido la captura (a menudo debido a una disputa o fraude). |
Para más detalles sobre los webhooks, consulte la documentación de PayPal a continuación:
- https://developer.paypal.com/docs/checkout/standard/customize/authorization/#how-it-works
- https://developer.paypal.com/api/rest/webhooks/event-names/#link-paymentsv
Glosario
- Autorización : La autorización permite “bloquear” los fondos en la cuenta de su cliente durante 3 días.
- Captura: La captura permite recuperar los fondos en su cuenta.
- Expirado : El plazo de 29 días ha expirado, el pedido se cancela.
- Cancelado : El pedido está cancelado.
- Re-autorización : La re-autorización permite “bloquear” nuevamente los fondos en la cuenta de su cliente durante 3 días.