> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cobrix.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Pagos

> Confirmación, fallo, aplicación y conversión de pagos

<div className="cobrix-category">
  <strong>La categoría financiera principal.</strong>
  <p>Los eventos separan la confirmación del pago, su fallo, su aplicación a saldos y los casos donde falta una tasa certificada.</p>
</div>

## Eventos

| Evento                                   | Qué ocurrió                                         | Acción recomendada                                        |
| ---------------------------------------- | --------------------------------------------------- | --------------------------------------------------------- |
| `payment.succeeded`                      | El pago quedó confirmado.                           | Marca el pago externo como confirmado usando `paymentId`. |
| `payment.failed`                         | El proveedor o la validación rechazó el pago.       | Muestra `reason` y permite otro intento.                  |
| `payment.applied_to_collection_document` | El pago redujo uno o más saldos.                    | Actualiza cada documento con el saldo recibido.           |
| `payment.requires_certified_rate`        | No pudo aplicarse por falta de conversión aprobada. | Envía la tasa mediante la API de integraciones.           |

<Columns cols={2}>
  <Card title="Pago confirmado" icon="circle-check" href="/guides/webhooks/events/payment-succeeded" cta="Ver payload" arrow />

  <Card title="Pago fallido" icon="circle-xmark" href="/guides/webhooks/events/payment-failed" cta="Ver payload" arrow />

  <Card title="Pago aplicado" icon="arrow-right-arrow-left" href="/guides/webhooks/events/payment-applied-to-collection-document" cta="Ver payload" arrow />

  <Card title="Falta tasa certificada" icon="scale-balanced" href="/guides/webhooks/events/payment-requires-certified-rate" cta="Ver payload" arrow />
</Columns>

<Info>
  Los objetos `customer`, `payment`, `paymentMethod` y `exchange` están documentados en [Modelos compartidos](/guides/webhooks/data-models).
</Info>