Ciclo de vida del pago
Los estados por los que pasa un pago, cuáles son terminales y cuándo puedes cumplir el pedido.
Toda transacción en Tonder empieza como un pago. Un pago exitoso puede después reembolsarse o contestarse como una disputa. Cada uno —pago, reembolso, disputa— recorre su propio conjunto de estados que te indican en qué punto del procesamiento se encuentra.
Entender estos estados es la base de todo lo demás: los webhooks reportan cambios de estado, tu cumplimiento de pedidos se activa con los estados terminales y tu dashboard agrupa las transacciones por ellos. Esta página es la referencia canónica de los tres.
Terminal vs. no terminal. Pending / Authorized / In review significan que el
procesamiento sigue en curso —aún no cumplas el pedido—. Success / Declined / Failed /
Cancelled / Won / Lost son terminales. Actúa solo sobre estados terminales y confírmalos
siempre del lado del servidor con webhooks, no con un redirect del
cliente.
Pagos
Un pago transfiere fondos del pagador al beneficiario por bienes o servicios. Cuando creas un pago siempre empieza en el estado Pending y luego avanza por el ciclo de abajo.
| Estado | ¿Terminal? | Descripción |
|---|---|---|
| Pending | No | Un intento de pago se está procesando. Común con procesadores asíncronos (p. ej. SPEI). Es el estado por defecto justo después de crearlo. |
| Authorized | No | El procesador autorizó el intento —los fondos están retenidos pero aún no capturados. |
| Declined | Sí | El procesador rechazó el intento. Consulta los códigos de rechazo. |
| Failed | Sí | El intento falló. Tonder muestra los detalles de la falla en el detalle del pago del dashboard. |
| Success | Sí | El intento se capturó con éxito. Es seguro cumplir el pedido. |
| Cancelled | Sí | Cancelado antes de la liquidación, a menudo por el cliente antes de completarlo. |
Reembolsos
Un reembolso es una devolución iniciada por el comercio hacia un cliente —por devoluciones, cancelaciones o insatisfacción. Lo inicias desde el dashboard de Tonder. Un reembolso también empieza en Pending.
| Estado | ¿Terminal? | Descripción |
|---|---|---|
| Pending | No | El reembolso está en espera de procesamiento. |
| Failed | Sí | El intento de reembolso no tuvo éxito. |
| Success | Sí | El reembolso se procesó con éxito. |
Disputas
Una disputa es una queja iniciada por el cliente que contesta una transacción —por ejemplo un cargo no autorizado, la no recepción de los bienes o insatisfacción. Cuando se crea una disputa empieza en Needs response y debes enviar evidencia para contestarla.
| Estado | ¿Terminal? | Descripción |
|---|---|---|
| Needs response | No | Tu cliente levantó una disputa con su banco; debes responder. |
| In review | No | La evidencia fue enviada y espera la decisión del procesador. |
| Lost | Sí | Perdiste la disputa, o la aceptaste al no responder a tiempo. |
| Won | Sí | Ganaste la disputa. |