# Cobros acreditados (/docs/payins)

<Endpoint method="GET" path="/v1/payins" href="/docs/api/funding/list-pay-ins" /> <Endpoint method="GET" path="/v1/payins/{id}" href="/docs/api/funding/get-pay-in" />

Cada vez que un pago entra a una cuenta de cobro, aparece un **payin**. El aviso del banco no basta para acreditar: Caibo confirma cada pago con el banco antes de acreditarlo, y cada pago se acredita **una sola vez**.

```json
{
  "id": "pin_01m3sg9x0000000000000000",
  "status": "completed",
  "funding_account_id": "fa_01m3sg9w0000000000000000",
  "amount": "45.871200",
  "currency": "USDT",
  "created_at": "2026-10-18T12:03:10Z",
  "completed_at": "2026-10-18T12:03:12Z"
}
```

| Campo | Qué es |
| --- | --- |
| `amount`, `currency` | **Lo que se acreditó a tu saldo**, en la moneda de liquidación. |
| `paid` | Lo que pagó el cliente en su moneda, cuando el banco lo informa por separado. |
| `funding_account_id` | La cuenta de cobro. El monto de tu orden está en su `amount`. |
| `failure_code` | Por qué falló, si falló. |
| `refunded`, `refundable` | Cuánto se reembolsó y cuánto queda por reembolsar (solo en `GET /v1/payins/{id}`). |

## Estados [#estados]

| `status` | Qué significa | Evento |
| --- | --- | --- |
| `processing` | Lo vimos y lo estamos confirmando con el banco. | — |
| `completed` | Confirmado y acreditado: el dinero está disponible. | `payin.completed` |
| `failed` | No se concretó. | `payin.failed` |

## Filtros [#filtros]

`GET /v1/payins?status=completed&funding_account_id=fa_…`, más `created_after` y `created_before`. Ver [Listas y paginación](/docs/pagination).

<Callout title="Si algo no cuadra">
Un pago con un monto distinto al pedido o que el banco revierte nunca mueve tu saldo automáticamente: lo revisa el equipo de Caibo y lo ves en `GET /v1/reconciliation-exceptions`.
</Callout>