Verificación del Beneficiario (VoP)

Visión general

La Verificación del Beneficiario (Verification of Payee, VoP) es un paso de validación opcional que puede aplicarse a los pagos salientes (payouts) con el fin de comprobar que los datos de la cuenta del beneficiario coinciden con el destinatario previsto.

Cuando VoP está habilitado, la plataforma realiza una verificación de titularidad de la cuenta justo antes de ejecutar el pago, utilizando el servicio de pago subyacente que ofrece esta funcionalidad.

En función de la configuración y del resultado de la verificación, el pago podrá ejecutarse, bloquearse o continuar a pesar de errores en la verificación.

---

Configuración

VoP se configura mediante el objeto extra_data.payment.vop en la solicitud de pago:

"extra_data": {
  "payment": {
    "vop": {
      "enabled": true,
      "accepted_verification_results": ["MATCH", "NO_MATCH"],
      "skip_on_error": true
    }
  }
}

---

Campos de VoP

Campo	Tipo	Descripción
enabled requerido	boolean	Activa la Verificación del Beneficiario. Cuando se establece en true, la plataforma realiza una comprobación VoP antes de ejecutar el pago.
accepted_verification_results	string[] (enum)	Lista de resultados de verificación que se consideran aceptables para continuar con el pago. Si el resultado real de VoP no está incluido en esta lista, el pago no se ejecutará. Si se omite o está vacía, el pago continúa independientemente del resultado de VoP. Valores permitidos: MATCH, NO_MATCH, CLOSE_MATCH, VERIFICATION_CHECK_NOT_POSSIBLE.
skip_on_error	boolean	Determina el comportamiento cuando una comprobación VoP no puede completarse debido a errores transitorios (por ejemplo, tiempos de espera o indisponibilidad temporal). Cuando es true, estos errores no bloquean el pago. Cuando es false o se omite, estos errores pueden impedir la ejecución.

---

Resultados de la verificación

Una comprobación VoP puede devolver uno de los siguientes resultados:

• MATCH – El nombre del beneficiario coincide completamente con el titular de la cuenta.
• CLOSE_MATCH – El nombre del beneficiario coincide de forma aproximada con el titular de la cuenta, con pequeñas discrepancias.
• NO_MATCH – El nombre del beneficiario no coincide con el titular de la cuenta.
• VERIFICATION_CHECK_NOT_POSSIBLE – No se pudo completar la verificación (por ejemplo, cuenta no compatible o limitaciones temporales del servicio).

Que el pago se ejecute o no depende de los valores definidos en accepted_verification_results y skip_on_error.

---

Pruebas en Sandbox

En entornos sandbox, pueden utilizarse IBAN específicos para simular distintos resultados de VoP con fines de prueba.

IBAN	Resultado simulado	Descripción
ES8569400001160529041877	rechazado	Simula siempre una verificación rechazada.
ES6769400001110836662135	fallido (NO_MATCH)	Simula siempre un resultado NO_MATCH.
ES3369400001190536473836	confirmado (CLOSE_MATCH)	Simula siempre una coincidencia aproximada.
Cualquier otro IBAN	confirmado (MATCH)	Simula siempre una coincidencia completa.

---