Cobros acreditados
El recurso payin es un pago que entró a una de tus cuentas de cobro, y lo que acreditó a tu saldo.
GET/v1/payins
GET/v1/payins/{id}
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.
{
"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
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
GET /v1/payins?status=completed&funding_account_id=fa_…, más created_after y created_before. Ver Listas y paginación.
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.