---
title: "Retrieve and cancel payments | Timbro"
description: "Check a payment's status or cancel it before it is captured"
canonical: "https://timbro.do/en/docs/cobros/consultar-pagos/"
---

Collect

# Retrieve and cancel payments

Save the payment `id` when you create the payment and use it to retrieve the result from your server:

- [TypeScript](https://timbro.do/en/docs/cobros/consultar-pagos/#tab-panel-0-0)
- [Python](https://timbro.do/en/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"` confirms that the money was captured. Compare `paymentReference`, currency, and amount with your order before applying the payment once. If you receive `processing` or `verifying`, wait and retrieve the same payment. See the other [payment states](https://timbro.do/en/docs/cobros/estados-del-pago/). A `succeeded` payment includes `refundable`, which tells you [whether a refund returns the money without the Timbro team stepping in](https://timbro.do/en/docs/cobros/reembolsos/#before-you-refund-read-refundable).

## Cancel

- [TypeScript](https://timbro.do/en/docs/cobros/consultar-pagos/#tab-panel-1-0)
- [Python](https://timbro.do/en/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")
```

If money has been captured or the outcome is still being confirmed, cancellation returns a conflict. For split payments with money held on the cards, it may return `releasing` until release is complete; retrieve the payment until it is `canceled`. To return money already collected, request a [refund](https://timbro.do/en/docs/cobros/reembolsos/).

## Search history

- [TypeScript](https://timbro.do/en/docs/cobros/consultar-pagos/#tab-panel-2-0)
- [Python](https://timbro.do/en/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` reads every page for you and takes the same filters, without `cursor`:

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

The listing returns `data`, `hasMore`, and `nextCursor`. To continue, send the cursor with the same filters. Available filters are in the [REST reference](https://timbro.do/en/docs/reference/payments/).

If you lost the creation response, do not create another payment. [Repeat the original request with the same reference](https://timbro.do/en/docs/produccion/recuperar-pago-incierto/) to get the same payment, or find it in the history with the exact `paymentReference` filter.

[Previous\
Invoice at the time of payment](https://timbro.do/en/docs/comprobantes/emitir-ecf/)[Next\
Payment states](https://timbro.do/en/docs/cobros/estados-del-pago/)

Sell, serve your customers, and collect payments from your phone

© 2026 Timbro. All rights reserved

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

## Products

[Invoicing](https://timbro.do/en/facturacion-electronica/)[Serve](https://timbro.do/en/atiende/)[Collect](https://timbro.do/en/pagos/)[Portal Timbro](https://timbro.do/en/portal-timbro/)[Integrations](https://timbro.do/en/integraciones/)[Cuenta Timbro](https://timbro.do/en/cuenta-timbro/)[Pricing](https://timbro.do/en/precios/)

## Developers

[SDKs and API](https://timbro.do/en/desarrolladores/)[Documentation](https://timbro.do/en/docs/)[API reference](https://timbro.do/en/docs/reference/payments/)

## Company

[INDEXA, the company behind Timbro](https://indexa.do/)[Presentations](https://timbro.do/en/presentaciones/)

## Help

[How to start](https://timbro.do/en/como-empezar/)[Electronic invoicing guide](https://timbro.do/en/guias/facturacion-electronica-republica-dominicana/)[Contact](https://timbro.do/en/contacto/)<hola@timbro.do>

## Legal

[Business Terms](https://timbro.do/en/politicas/negocios/)[Terms of use](https://timbro.do/en/politicas/uso/)[Privacy](https://timbro.do/en/politicas/privacidad/)[Security](https://timbro.do/en/politicas/seguridad/)[All documents](https://timbro.do/en/politicas/)