Incrementar autorización
Aumenta una retención de autorización existente en un monto delta, sin crear una nueva autorización.
amount que envías es un delta: cuánto se suma al monto autorizado actual. Yuno lo traduce a la semántica que espera cada proveedor.
Cada incremento crea su propia transacción AUTHORIZE_INCREMENT con un resultado por incremento, visible en Retrieve Payment. Los incrementos se notifican con el evento de webhook payment.authorize, así que suscríbete al disparador AUTHORIZE para recibirlos; no existe un evento de incremento separado. Un incremento exitoso aumenta payment.amount.authorized; payment.amount.value conserva el monto original. Un incremento rechazado deja intacto el monto autorizado previamente. Se pueden hacer varios incrementos sobre la misma autorización, pero deben ser secuenciales: un nuevo incremento solicitado mientras otro anterior sigue en curso devuelve un 400.
Ten en cuenta que esta solicitud requiere un X-Idempotency-Key. Consulta la página Authentication para obtener más información.
Capturar después de los incrementos
Una captura con unamount explícito puede liquidar cualquier monto hasta el total autorizado actual (la autorización original más todos los incrementos exitosos). Una captura sin monto liquida la retención actual completa de la transacción: el monto autorizado original más todos los incrementos SUCCEEDED de esa transacción. Los incrementos que sigan en PENDING al momento de la captura no se incluyen.
Compatibilidad por proveedor
La compatibilidad depende del proveedor. Si el proveedor enrutado para el pago no admite autorizaciones incrementales, la llamada igualmente devuelve201, pero con una transacción de incremento cuyo status es ERROR y cuyo response_code es OPERATION_NOT_SUPPORTED_BY_PROVIDER. No es un error HTTP, por lo que debes basarte en el status de la transacción y no en el código de estado HTTP. El monto autorizado previamente queda intacto.
Revolut es actualmente el único proveedor con compatibilidad con autorización incremental.
OPERATION_NOT_SUPPORTED_BY_PROVIDER descrita arriba.Autorizaciones
Parámetros de ruta
Cuerpo
Respuesta
201
Resultado por incremento. SUCCEEDED: la retención se aumentó. DECLINED: el emisor o el proveedor rechazó este incremento; el monto autorizado anterior se mantiene. PENDING: el proveedor procesa los incrementos de forma asíncrona; el resultado final se entrega por webhook. ERROR: no se pudo procesar el incremento.
SUCCEEDED, DECLINED, PENDING, ERROR Código de respuesta de Yuno para este incremento: el subestado de la transacción cuando el proveedor devuelve uno; de lo contrario, el estado de la transacción (por ejemplo SUCCEEDED, PENDING_PROVIDER_CONFIRMATION, AUTHORIZATION_NOT_INCREMENTABLE). No es un código de emisor ISO 8583. AUTHORIZATION_NOT_INCREMENTABLE indica que el proveedor rechazó el incremento, ya sea porque la autorización original no se creó como PRE_AUTHORIZATION o porque se superaron los límites de incremento del proveedor (por ejemplo, más de 10 incrementos o un total superior a 5 veces el monto inicial en Revolut).