Saltar al contenido principal

Autorización y captura separadas

Cuando creás un pago, podés autorizar un monto y capturarlo después. Este flujo es útil cuando necesitás reservar fondos antes de completar el cobro, por ejemplo en hoteles, alquileres o pedidos que requieren confirmación final.

info

La captura manual solo está disponible para pagos con tarjeta en integraciones 100% vía API. No está disponible para Checkout ni para el SDK de pago embebido.

Referencia API relacionada​

Crear la intención​

Indicá captureMethod: "manual" al crear la intención de pago.

{
  "amount": 1000,
  "currency": "USD",
  "captureMethod": "manual"
}

Luego confirmá la intención con un método de pago de tipo tarjeta.

Si la autorización se aprueba, la intención queda en estado requires_capture. Si se declina, vuelve a requires_payment_method y podés intentar con otro método de pago.

Capturar fondos​

Para capturar el monto autorizado, llamá al endpoint de captura de intención de pago. Por defecto, ONVO captura el monto total autorizado.

Para capturar menos que el monto original, enviá amountToCapture. Una captura parcial libera automáticamente el monto restante.

{
  "amountToCapture": 750
}

Si la captura es exitosa, la intención cambia a succeeded. Si la captura falla, la intención cambia a requires_payment_method y necesitás iniciar una nueva autorización.

Cancelar una autorización​

Si necesitás liberar los fondos antes de capturarlos, cancelá la intención de pago. Si la autorización expira antes de capturarla, ONVO libera los fondos y la intención cambia a canceled.