---
title: "Consultar y cancelar pagos | Timbro"
description: "Confirma si se cobró un pago, cancélalo o busca en el historial"
canonical: "https://timbro.do/docs/cobros/consultar-pagos/"
---

Cobrar

# Consultar y cancelar pagos

Guarda el `id` del pago al crearlo y úsalo para consultar el resultado desde tu servidor:

- [TypeScript](https://timbro.do/docs/cobros/consultar-pagos/#tab-panel-0-0)
- [Python](https://timbro.do/docs/cobros/consultar-pagos/#tab-panel-0-1)

```ts
import { createTimbroPayments } from "@timbro/payments";

const timbro = createTimbroPayments({ apiKey: process.env.TIMBRO_PAYMENTS_SECRET_KEY! });
const payment = await timbro.payments.retrieve("payment_123456789abcdefghjkmnpqr");
```

```python
import os

from timbro_payments import TimbroPayments

timbro = TimbroPayments(api_key=os.environ["TIMBRO_PAYMENTS_SECRET_KEY"])
payment = timbro.payments.retrieve("payment_123456789abcdefghjkmnpqr")
```

`status: "succeeded"` confirma que el pago se completó. Comprueba que `paymentReference`, la moneda y el monto coincidan con tu pedido antes de marcarlo como pagado. Evita volver a registrarlo si ya lo hiciste. Si recibes `processing` o `verifying`, espera y consulta el mismo pago de nuevo. Revisa los demás [estados](https://timbro.do/docs/cobros/estados-del-pago/). Un pago `succeeded` incluye `refundable`, que indica [si un reembolso devolverá el dinero sin que intervenga el equipo de Timbro](https://timbro.do/docs/cobros/reembolsos/#antes-de-reembolsar-lee-refundable).

## Cancelar

- [TypeScript](https://timbro.do/docs/cobros/consultar-pagos/#tab-panel-1-0)
- [Python](https://timbro.do/docs/cobros/consultar-pagos/#tab-panel-1-1)

```ts
const canceled = await timbro.payments.cancel({ paymentId: "payment_123456789abcdefghjkmnpqr" });
```

```python
canceled = timbro.payments.cancel("payment_123456789abcdefghjkmnpqr")
```

No puedes cancelar un pago si ya se cobró dinero o si todavía se está comprobando el resultado. En esos casos, la API responde con un conflicto (`409`).

Si el pago está dividido y hay montos retenidos en las tarjetas, Timbro debe liberarlos antes de cancelarlo. Puedes recibir `releasing`: sigue consultando hasta recibir `canceled`. Para devolver dinero que ya se cobró, solicita un [reembolso](https://timbro.do/docs/cobros/reembolsos/).

## Buscar en el historial

- [TypeScript](https://timbro.do/docs/cobros/consultar-pagos/#tab-panel-2-0)
- [Python](https://timbro.do/docs/cobros/consultar-pagos/#tab-panel-2-1)

```ts
const page = await timbro.payments.list({ limit: 20 });
```

```python
page = timbro.payments.list(limit=20)
```

`list_all` recorre todas las páginas por ti y acepta los mismos filtros, sin `cursor`:

```python
for succeeded in timbro.payments.list_all(status=["succeeded"]):
    print(succeeded["paymentReference"], succeeded["totalAmount"]["value"])
```

`data` contiene los pagos de esta página. Si `hasMore` es `true`, envía `nextCursor` en la siguiente consulta para obtener más pagos, usando los mismos filtros. Consulta los filtros disponibles en la [referencia REST](https://timbro.do/docs/reference/payments/).

Si no recibiste la respuesta al crear el pago, no crees otro. [Reenvía la solicitud original con la misma referencia](https://timbro.do/docs/produccion/recuperar-pago-incierto/) y Timbro te devolverá el mismo pago, o búscalo en el historial con el filtro exacto `paymentReference`.

[Página anterior\
Facturar al momento del pago](https://timbro.do/docs/comprobantes/emitir-ecf/)[Siguiente página\
Estados del pago](https://timbro.do/docs/cobros/estados-del-pago/)

Vende, atiende a tus clientes y cobra desde tu celular

© 2026 Timbro. Todos los derechos reservados

[Español](https://timbro.do/docs/cobros/consultar-pagos/)[English](https://timbro.do/en/docs/cobros/consultar-pagos/)

## 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/)<hola@timbro.do>

## 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/)