Skip to main content

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.