Cuando tus clientes pagan por débito inmediato, Cobrix recibe el dinero y luego te lo transfiere. Cada transferencia a tus cuentas es una dispersión. Con estos tres endpoints tu sistema concilia solo, sin copiar nada del panel. Los montos son los mismos que ves en «Dispersiones».
payouts:read
Operaciones
1
Pide tus dispersiones
GET /payouts sin filtros devuelve las más nuevas primero. Si quieres un periodo, agrega createdFrom y createdTo. Una fecha sola, como 2026-11-30, cuenta el día completo en hora de Caracas. Para filtrar por estado, usa status.2
Mira a qué cuentas fue el dinero
GET /payouts/{payoutId} trae una transferencia por cuenta. Cada una muestra el banco, los últimos 4 dígitos (•••• 2345), el estado y el bankReference, que es la referencia que vas a ver en tu estado de cuenta.3
Une cada monto con tus ventas
GET /payouts/{payoutId}/payments lista las ventas de esa dispersión, cada una con el amountMinor que esta dispersión te envió de ella. Únela a tu venta por paymentId, el mismo de payment.succeeded y de un débito de POST /direct-debits, o por el sessionId que te respondió POST collection-documents/checkout-sessions.Los tres montos de una dispersión
En el caso normal,
salesMinor − costMinor = receivedMinor. Si no cuadra, es porque una parte se movió a otra cuenta o a otra dispersión: el estado partly_redirected y las transferencias te dicen dónde fue. Los montos van en unidades menores, como en el resto de la API.
Estados
Errores
Las cuentas siempre salen enmascaradas: nunca el número completo ni el titular.

