Pagos - Cobrix Docs

Los montos usan unidades menores. Cobrix valida documentos, saldo, moneda e idempotencia antes de aplicar el pago al ledger.

verified_payments:writepayments:readcertified_rates:write

Operaciones

Permiso del drawer	Scope	Método y ruta
Listar y consultar pagos	`payments:read`	`GET /integrations/v1/{companyId}/payments`
Listar y consultar pagos	`payments:read`	`GET /integrations/v1/{companyId}/payments/{externalPaymentId}`
Reportar pagos verificados	`verified_payments:write`	`POST /integrations/v1/{companyId}/verified-payments`
Cargar tasas certificadas	`certified_rates:write`	`POST /integrations/v1/{companyId}/payments/{externalPaymentId}/certified-rate`

Reportar
Consultar
Certificar tasa

Envía source, externalPaymentId, cliente, amountMinor, moneda, verifiedAt y los documentos a aplicar. El header Idempotency-Key es obligatorio.

Filtra por estado, estado operativo, pago externo, cliente, source, proveedor, moneda, rango de pago o updatedSince.

Si el pago queda en needs_certified_rate, envía moneda y monto de referencia, exchangeRateUsed, fecha efectiva y distribución entre documentos.

Estados operativos

Estado	Qué significa	Próxima acción
`applied`	Pago aplicado completamente	Ninguna
`partially_applied`	Solo parte pudo aplicarse	Consulta el detalle y saldo restante
`credited`	Existe remanente registrado como crédito	Revisa `creditCreatedMinor`
`needs_certified_rate`	Falta una tasa aprobada	Envía la tasa certificada
`no_open_documents`	No había documentos aplicables	Corrige la selección antes de reintentar
`already_processed`	La intención ya fue procesada	Reutiliza la respuesta existente
`failed`	La aplicación no terminó	Busca `requestId` y detalle en Auditoría

No inventes una tasa ni reenvíes el pago con otro identificador para superar un conflicto. Consulta primero el pago existente; duplicar la intención puede producir una doble aplicación.

Reportar pago

Revisa distribución, moneda, timestamp y respuestas financieras.

Consultar pagos

Confirma el resultado operativo antes de ejecutar acciones posteriores.

​Operaciones

​Estados operativos

Reportar pago

Consultar pagos

Operaciones

Estados operativos