Autorización parcial

Las autorizaciones parciales permiten procesar un pago incluso cuando la tarjeta del cliente no dispone de fondos suficientes para cubrir el importe total de la orden. En lugar de rechazar la operación, el sistema autoriza el máximo importe disponible en la tarjeta. Esta funcionalidad es especialmente útil para modelos de negocio que pueden gestionar el importe restante mediante otro método de pago o un nuevo intento de cobro.

Solamente algunos bancos soportan autorizaciones parciales. Si el banco no la soporta y el usuario no tiene suficientes fondos, se producirá un error tipo UNSPECIFIED REFUSAL o INSUFFICIENT FUNDS, tal y como sucede al utilizar la operativa AUTHORIZATION.

Uso

Para solicitar la autorización parcial de los fondos debes utilizar la operativa PARTIAL_AUTHORIZATION al crear la orden de pago. Esta operativa puede utilizarse tanto en el flujo CIT (Customer Initiated Transaction) como el flujo MIT (Merchant Initiated Transaction), con y sin 3DS. Cuando finalice la operación, el importe de la transacción corresponderá al importe autorizado. En caso de querer llevar a cabo una devolución, solamente podrá devolverse el importe autorizado, no el importe original de la orden.

A continuación se muestra la respuesta de un pago exitoso en el que se ha llevado a cabo una autorización parcial. El comercio solicita el cobro de 6 euros de los cuales finalmente se autorizan 1,80 euros.

{
  "message": "OK",
  "code": 200,
  "order": {
    "uuid": "6E317E9E-1508-487A-98CB-389F7054B9CF",
    "amount": 600,
    "currency": "978",
    "paid": true,
    "status": "SUCCESS",
    "transactions": [
      {
        "uuid": "1EAC092C-5A96-49E3-8FDB-D2374DE2F3B9",
        "operative": "PARTIAL_AUTHORIZATION",
        "amount": 180,
        "status": "SUCCESS",
        "error": "NONE",
        ...
      }
    ]
  },
  ...
}

Configurar un importe a autorizar mínimo

Para prevenir aquellas situaciones en las cuales el importe autorizado es demasiado bajo (unos pocos céntimos) debido a que el usuario no dispone de fondos suficientes para cubrir el importe total de la orden, puede definirse un importe mínimo a autorizar al generar la orden de pago. Si se especifica este importe mínimo y la cantidad finalmente autorizada no lo alcanza, los fondos retenidos se liberarán automáticamente para que el usuario pueda seleccionar otro método de pago.

Para configurar este importe, basta indicarlo en el campo extra_data.partial_authorization.min_threshold. En este caso, si el importe autorizado es menos de 1.60 euros, el importe autorizado será liberado. Este importe se expresa en la misma moneda que la orden.

...
    "extra_data": {
        "partial_authorization": {
            "min_threshold": 160
        },
...

Si se llegara a autorizar solamente un euro, se recibiría el siguiente error:

{
    "message": "OK",
    "code": 200,
    "current_time": "2026-05-06T15:41:09+0200",
    "order": {
        "amount": 600,
        "currency": "978",
        "paid": false,
        "status": "REFUSED",
        ...
        "transactions": [
            {
                "operative": "PARTIAL_AUTHORIZATION",
                "amount": 100,
                "status": "REFUSED",
                "error": "The charged amount is below the minimum allowed threshold",
                ...
                "error_details": {
                    "error_code": null,
                    "error_description": null,
                    "error_code_scheme": null,
                    "error_description_scheme": null,
                    "error_unified": "AMOUNT BELOW THRESHOLD"
                },
                ...

Datos de prueba

Durante el proceso de integración pueden llevarse a cabo pruebas de pago en el entorno sandbox, utilizando un servicio de tipo PaynoPain o mediante nuestro simulador Paylands.

PaynoPain

Para simular una autorización parcial con un servicio de tipo PaynoPain, envía una petición con el siguiente importe:

amount: 100010

Paylands

Para simular una autorización parcial con un servicio de tipo Paylands, utiliza la siguiente tarjeta:

4000058400000071

Comportamiento del simulador:

• Para pagos con un amount superior a 100, el simulador aplicará una autorización parcial.
• Para pagos con un amount igual o inferior a 100, se autorizará el importe completo.

Para más información sobre el simulador, consulta la documentación del servicio de Paylands.