--- title: "Estados del pago | Timbro" description: "Comprueba si el cliente pagó y qué debes hacer con el pedido" canonical: "https://timbro.do/docs/cobros/estados-del-pago/" --- Cobrar # Estados del pago Consulta el pago desde tu servidor y usa su campo `status` para decidir qué hacer: | Estado | Qué hacer | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `requires_customer_action` | Lleva al cliente a `checkout.url` para que continúe el pago. Si tiene `lastDecline`, el último intento fue rechazado y el cliente puede intentarlo de nuevo. | | `processing` | El pago está en curso. Espera y consulta el mismo pago. | | `verifying` | El resultado todavía no se conoce. Espera; no inicies otro pago. | | `partially_paid` | Se cobró una parte de un pago dividido, pero falta dinero por cobrar. | | `succeeded` | El pago está confirmado. Marca el pedido como pagado una sola vez. | | `canceled` | El pago terminó cancelado. | | `expired` | El Checkout no se completó antes de `expiresAt`. Crea otro pago si el cliente aún quiere pagar; para una suscripción, consulta la regla de abajo. | Los estados `succeeded`, `canceled` y `expired` indican que el pago terminó. Si vuelves a enviar su `paymentReference`, recibirás ese mismo pago, sin iniciar otro pago. Para cobrar de nuevo necesitas otra referencia, pero primero confirma qué pasó con el anterior y resuelve cualquier parte pendiente. ## Intentos rechazados Un rechazo termina el intento, no el pago. El pago vuelve a `requires_customer_action` y `lastDecline` indica el motivo normalizado (`code`), un mensaje para el cliente (`message`) y cuándo ocurrió (`attemptedAt`). El cliente puede volver a intentarlo con el mismo link hasta que el pago venza. Cada intento rechazado envía el webhook `payment.declined`. No crees otro pago por un rechazo. ## Plazo del pago `expiresAt` indica cuándo vence el Checkout. Por defecto son 30 minutos con `returnUrl` y 1 hora sin él; envía `expiresAfterSeconds` al crear el pago para cambiarlo, entre 300 y 86400 segundos. [Define cuánto tiempo queda abierto el QR](https://timbro.do/docs/cobros/qr-y-nfc/#define-cu%C3%A1nto-tiempo-queda-abierto-el-qr). ### Pagos de suscripción El primer pago para configurar una suscripción vence a las 24 horas. Si vence, la suscripción termina; para empezar de nuevo, crea otra con una `subscriptionReference` nueva. Una renovación puede seguir en `requires_customer_action` con `expiresAt` y `checkout.expiresAt` en `null` hasta que el proveedor de email acepte el envío del aviso de pago pendiente. Entonces Timbro fija el vencimiento en 7 días. Mantén disponible el link de Checkout y no muestres una cuenta regresiva mientras la fecha sea `null`. Reenviar el aviso no extiende un vencimiento ya fijado. Si el proveedor rechaza el aviso, `recoveryNotice.problem` es `notice_handoff_failed` y Timbro no lo reintenta: comparte el link o reenvía el aviso. Cada pago admite 3 reenvíos en 24 horas. ## División de pagos Al dividir una cuenta, Timbro puede retener el monto de cada parte en su tarjeta antes de cobrarlo. Un monto retenido todavía no confirma el pago. - `partially_authorized` o `authorized`: hay montos retenidos en las tarjetas. - `capturing`: Timbro está cobrando los montos retenidos. - `releasing`: Timbro está liberando los montos retenidos. - `partially_paid`: se cobró una parte, pero pueden quedar otras pendientes. Revisa el detalle de cada parte en `split` antes de dar la cuenta por pagada. ## Si pediste un e-CF `succeeded` confirma el pago, no la aceptación fiscal. Consulta el e-CF por su `invoiceId` para revisar el estado y los archivos. [Facturar al momento del pago](https://timbro.do/docs/comprobantes/emitir-ecf/). [Confirmar un pago sin respuesta](https://timbro.do/docs/produccion/recuperar-pago-incierto/) [Página anterior\ Consultar y cancelar pagos](https://timbro.do/docs/cobros/consultar-pagos/)[Siguiente página\ Impuestos y artículos](https://timbro.do/docs/cobros/impuestos-y-articulos/) Vende, atiende a tus clientes y cobra desde tu celular © 2026 Timbro. Todos los derechos reservados [Español](https://timbro.do/docs/cobros/estados-del-pago/)[English](https://timbro.do/en/docs/cobros/estados-del-pago/) ## Productos [Facturación](https://timbro.do/facturacion-electronica/)[Atiende](https://timbro.do/atiende/)[Cobra](https://timbro.do/pagos/)[Portal Timbro](https://timbro.do/portal-timbro/)[Integraciones](https://timbro.do/integraciones/)[Cuenta Timbro](https://timbro.do/cuenta-timbro/)[Precios](https://timbro.do/precios/) ## Desarrolladores [SDK y API](https://timbro.do/desarrolladores/)[Documentación](https://timbro.do/docs/)[Referencia de la API](https://timbro.do/docs/reference/payments/) ## Empresa [INDEXA, la empresa detrás de Timbro](https://indexa.do/)[Presentaciones](https://timbro.do/presentaciones/) ## Ayuda [Cómo empezar](https://timbro.do/como-empezar/)[Guía de facturación electrónica](https://timbro.do/guias/facturacion-electronica-republica-dominicana/)[Contacto](https://timbro.do/contacto/) ## Legal [Condiciones para negocios](https://timbro.do/politicas/negocios/)[Política de uso](https://timbro.do/politicas/uso/)[Privacidad](https://timbro.do/politicas/privacidad/)[Seguridad](https://timbro.do/politicas/seguridad/)[Todos los documentos](https://timbro.do/politicas/)