Conciliación de PayOuts
Movimientos de Dinero vs. Transacciones
| Identificador | Prefijo | Se genera cuando | Representa |
|---|---|---|---|
| ID del Movimiento de Dinero | mm_ | Se crea el PayOut | La intención/solicitud de pago y su estado del ciclo de vida |
| ID de la Transacción | trx_ | Se debitan o acreditan fondos en tu Cobre Balance | El registro contable real que afecta el balance |
metadata.money_movement_id que la vincula de vuelta — usa este campo para agrupar Transacciones por el PayOut que las generó.external_id al crear un PayOut (Crear un Movimiento de Dinero). Se retorna en el Movimiento de Dinero y es la forma más simple de hacer coincidir un PayOut de Cobre con tu factura, orden o registro de pago interno.Ciclo de Vida del PayOut e Impacto en el Balance
status.state de un PayOut te indica si se completó, y su status.code / status.description explican por qué cuando no fue así. Consulta Estados de Movimientos de Dinero para el catálogo completo de códigos de motivo, y la guía de Movimiento de Dinero para el modelo completo del ciclo de vida.| Estado terminal | Transacciones típicas | Impacto neto en el balance |
|---|---|---|
completed | 1 débito | Negativo (fondos enviados) |
canceled | 0 (cancelado antes de aplicar un débito — p. ej., una aprobación fue denegada) | Ninguno |
failed | 0 — un PayOut fallido nunca genera un débito | Ninguno |
rejected | 0, o 1 débito + 1 crédito compensatorio si ya se había aplicado un débito | Ninguno (si se revierte) |
failed y rejected no son intercambiables para efectos de conciliación. failed cubre problemas operativos o de plataforma detectados antes de aplicar cualquier débito (p. ej., NSF, límites excedidos, errores de procesamiento) — nunca hay una Transacción que buscar. rejected cubre rechazos a nivel de riel o de banco, que pueden ocurrir después de que el débito ya se aplicó — ese es el caso que produce el crédito compensatorio descrito abajo.completed a rejected si el banco destino devuelve los fondos después de que Cobre ya confirmó la finalización. Cuando esto ocurre, Cobre aplica una transacción de crédito compensatoria en tu Cobre Balance. No trates completed como un estado de balance permanentemente final para efectos de conciliación — siempre verifica si existe una Transacción de reversión posterior bajo el mismo money_movement_id.spei_return que compensa el spei_debit original — concilia las reversiones de PayOuts en México haciendo coincidir estos dos tipos de transacción bajo el mismo money_movement_id.Conciliar PayOuts a Demanda
GET /money_movements) directamente cuando necesites revisar un PayOut específico o un lote pequeño:| Filtro | Úsalo para |
|---|---|
state | Aislar PayOuts completed, rejected, failed o canceled |
external_id | Encontrar el Movimiento de Dinero de una referencia interna específica (coincidencia parcial) |
source_id / destination_id | Conciliar todos los PayOuts desde un Cobre Balance o hacia una contraparte |
created_at_gte / created_at_lte | Acotar la consulta a un rango de fechas |
amount, amount_gte, amount_lte, currency | Acotar por valor |
GET /accounts/{acct_id}/transactions), filtrando credit_debit_type=debit y haciendo coincidir metadata.money_movement_id, para confirmar el lado que afecta el balance de cada PayOut.Conciliar PayOuts en Bloque
1.
money_movement_csv_v1 para CSV, o money_movement_v1 para JSON) y otro para el lado de la Transacción (transactions_csv_v1 para CSV, o account_transactions_v1 para JSON), sobre el mismo rango de fechas.2.
metadata.money_movement_id.3.
money_movement_id con exactamente una fila de débito concilia como un PayOut completado; uno con un débito y un crédito compensatorio concilia como un rechazo o falla reversado.Conciliar PayOuts en Tiempo Real
money_movements.status.completed, money_movements.status.rejected, money_movements.status.failed, money_movements.status.canceled), para que puedas actualizar tu contabilidad en el momento en que ocurre, en lugar de consultarlo repetidamente.Conciliación del Balance de Apertura y Cierre
Acciones Permitidas en la Conciliación de PayOuts
🔍 Consulta — Movimientos de Dinero
🔍 Consulta — Transacciones
🔍 Consulta — Historial de Balance Diario
🔑 Reportes
Descripción: Consulta PayOuts a demanda por estado, ID externo, contraparte, rango de fechas o monto.Qué esperar después de la acción: Una lista paginada de objetos Movimiento de Dinero con su 📘 Más información:
status actual.Cómo Empezar
Siempre proporciona external_id en cada PayOut
Es la forma más rápida de hacer coincidir un Movimiento de Dinero de Cobre con tu registro interno, y es consultable mediante el filtro
external_id.Suscríbete a los eventos de estado del Movimiento de Dinero en lugar de consultar repetidamente
Consulta Notificaciones y Suscripciones para recibir notificaciones casi en tiempo real en lugar de consultar la API repetidamente.
Conoce los códigos de motivo de tu riel
Revisa Estados de Movimientos de Dinero para que el
code y la description de un PayOut failed o rejected sean accionables en lugar de opacos.Decide de antemano entre consultas a demanda y Reportes
Usa consultas a demanda para PayOuts individuales o lotes pequeños, y Reportes para conciliación por rango de fechas o de alto volumen.
Qué Esperar Después de Usar esta API
Cada PayOut se resuelve en un par Movimiento de Dinero + Transacción emparejado
Los PayOuts completados muestran un débito; los rechazos o fallas reversados muestran un débito y un crédito compensatorio bajo el mismo
money_movement_id.Los balances de apertura y cierre se validan contra el Historial de Balance Diario
initial_balance y end_balance del Historial de Balance Diario coinciden con lo que calculas manualmente a partir de las Transacciones ordenadas.Las discrepancias se aíslan a un money_movement_id específico
Cualquier discrepancia de balance se acota a un solo PayOut que puedes investigar directamente a través de sus registros de Movimiento de Dinero y Transacción.
Modified at 2026-08-21 01:07:08