Recursos

MyBankMatch

Verifique si un IBAN pertenece al titular indicado mediante la Verificación del Beneficiario (VoP) del banco propio vinculado a su licencia de WealthReader.

Producto en validación. La implementación de esta versión cubre Santander particulares y el entorno de producción, pero su compatibilidad bancaria, configuración y aceptación en vivo todavía están pendientes. Confirme la habilitación con soporte antes de utilizarlo en producción. Los ejemplos de esta página no prueban resultados reales del banco.

Preparar la conexión

Disponga de una licencia activa con el producto MY_BANK_MATCH y cuota disponible.
Abra Clientes · MyBankMatch con su sesión autenticada y la licencia correspondiente.
Pulse Conectar banco y complete la autenticación en la ventana alojada de WealthReader. La conexión tokenizada queda asociada a su api_key; el token bancario no se entrega al navegador ni es un parámetro de consulta.
Actualice el estado en Clientes. Si el banco requiere autenticarse de nuevo, utilice Volver a conectar. El panel también ofrece una prueba explícita de IBAN/nombre y las últimas consultas enmascaradas.

El emisor utiliza un enlace firmado de un solo uso y una continuación ligada al navegador. Si el enlace ha caducado o pierde esa continuación, solicite otro desde Clientes. La vinculación admite Santander particulares; otros bancos, cuentas de empresa y entornos dedicados no están cubiertos por este flujo.

Antes del despliegue deben estar aplicadas las tablas del producto y configurado MY_BANK_MATCH_LINK_SIGNING_KEY (al menos 32 bytes) en Clientes y el widget. Esta documentación no acredita que esos requisitos estén instalados. Un fallo de configuración no equivale a una conexión correcta.

Enviar una consulta desde el backend

POST https://api.wealthreader.com/my-bank-match/
Content-Type: application/x-www-form-urlencoded

Parámetro	Obligatorio	Contrato
`api_key`	Sí	Clave de 8 caracteres hexadecimales de una licencia activa con `MY_BANK_MATCH` y cuota disponible. Manténgala en el backend.
`iban`	Sí	IBAN de un país SEPA. Se eliminan los espacios, se pasa a mayúsculas y se valida la longitud del país y el control mod-97.
`name`	Sí	Nombre del titular, no vacío, UTF-8 válido, sin caracteres de control y hasta 140 caracteres. Se recorta y se normalizan espacios.

No se envía JSON ni se usa X-API-Key: la clave forma parte del cuerpo codificado como formulario, igual que en /entities/. No envíe credenciales bancarias ni un token del banco a este método.

curl --request POST 'https://api.wealthreader.com/my-bank-match/' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'api_key=<SU_API_KEY>' \
  --data-urlencode 'iban=ES9321005707250200257112' \
  --data-urlencode 'name=WEALTH READER S.L.'

<SU_API_KEY> es un marcador, no una clave utilizable. El IBAN y nombre ilustran la solicitud de aceptación; no se ha comprobado aquí que produzcan un veredicto concreto. La consulta puede ser facturable: no la lance como un refresco automático de interfaz.

MyBankMatch devuelve el veredicto del banco. No sustituye esa respuesta por un cálculo local de similitud de nombres. Tampoco crea, autoriza ni ejecuta una orden de pago.

Interpretar la respuesta

HTTP 200 indica que se ha obtenido un resultado del producto, no que el nombre necesariamente coincida. Compruebe success y después payload.result.

Ejemplo ilustrativo de coincidencia parcial (nombre y SESSION simulados):

{
  "success": true,
  "payload": {
    "result": "PARTIAL_MATCH",
    "suggested_name": "TITULAR DE EJEMPLO S.L."
  },
  "statistics": {
    "SESSION": "0000000000000000",
    "execution_time": 0.42,
    "warnings": []
  }
}

statistics.SESSION identifica esta consulta para diagnóstico y execution_time se expresa en segundos. Una respuesta correcta no incluye un objeto error ni devuelve el token de la conexión bancaria.

`payload.result`	Significado	Campos adicionales	Facturable
`MATCH`	El banco considera que el nombre coincide con el titular.	Ninguno.	Sí, 0,10 EUR.
`PARTIAL_MATCH`	El banco devuelve una coincidencia parcial (`CLOSE_MATCH`).	`suggested_name`: nombre real comunicado por el banco, no una sugerencia generada localmente.	Sí, 0,10 EUR.
`NO_MATCH`	El banco indica que el nombre no coincide.	Ninguno.	Sí, 0,10 EUR.
`NOT_CONFIGURED`	La licencia todavía no tiene un banco vinculado.	`setup_url`.	No.
`REAUTH_REQUIRED`	La conexión necesita una nueva autenticación.	`setup_url` y `reason_code`, entero de la familia 2xxx.	No.
`NOT_POSSIBLE`	No ha sido posible obtener un veredicto utilizable. No equivale a `NO_MATCH`.	`reason`, un identificador técnico.	No.

En coincidencia parcial, muestre por separado el nombre introducido y suggested_name; no reemplace silenciosamente el primero. Si los presenta en HTML, escápelos como texto.

La URL de preparación de NOT_CONFIGURED y REAUTH_REQUIRED es:

https://www.wealthreader.com/clients/#my-bank-match

Por ejemplo, una reautenticación puede devolver este payload:

{
  "result": "REAUTH_REQUIRED",
  "setup_url": "https://www.wealthreader.com/clients/#my-bank-match",
  "reason_code": 2000
}

reason_code debe ser un entero entre 2000 y 2999; por ejemplo, 2000 corresponde a un fallo de credenciales. Vuelva a conectar desde Clientes en lugar de repetir indefinidamente la verificación.

NOT_POSSIBLE puede deberse a una indisponibilidad transitoria, una respuesta bancaria no válida, falta de un IBAN pagador utilizable o un adaptador no disponible. Conserve reason para diagnóstico, pero no convierta esos casos en una confirmación de titularidad ni en una coincidencia negativa.

Validación, cuota y errores

Los errores de validación o licencia siguen el sobre habitual: success: false, payload, error.code, error.message y statistics con SESSION, duración y avisos. Las validaciones controladas responden HTTP 400; el mensaje puede incluir información de diagnóstico y no debe usarse como identificador estable.

`error.code`	Motivo
`4000`	IBAN no válido: formato, país no admitido, longitud o dígitos de control.
`4001`	Nombre no válido: vacío, formato o longitud.
`2`	Método o `api_key` incorrectos, licencia inactiva, producto no permitido o cuota agotada.
`1`	Error interno de disponibilidad o persistencia.

Los errores de entrada y los resultados no concluyentes no consumen la cuota de consultas facturables. La cuota se consume cuando el banco devuelve MATCH, PARTIAL_MATCH o NO_MATCH; si otra llamada la agota concurrentemente, se devuelve el error de límite en vez de confirmar el resultado como correcto.

No hay una clave de idempotencia ni una garantía de reintento gratuito en este método. Si pierde la respuesta por timeout, red o un cuerpo no interpretable, el resultado y su consumo de cuota pueden ser desconocidos para su aplicación. No vuelva a enviar automáticamente la misma consulta: compruebe el historial de Clientes y consulte con soporte si necesita aclarar el intento.

El precio de 0,10 EUR corresponde únicamente a los tres resultados concluyentes del contrato. El modo de facturación por consulta y la exclusión de sesiones de vinculación verificadas están implementados, pero requieren el esquema previo y la activación/revisión de las consultas de facturación por un operador; esta página no acredita ese despliegue. Sólo una asociación servidor verificada permite excluir una sesión del cálculo estándar de credenciales/productos: un operation_id del navegador no basta. Intentos caducados, no auditados o históricos sin esa procedencia no tienen exención automática, ni se garantizan otros efectos de contador gratuitos.

Límites de esta versión

La verificación usa la conexión propia tokenizada del cliente con Santander particulares. No se ha validado todavía la compatibilidad bancaria real ni se garantiza disponibilidad comercial por publicar esta página.
El flujo alojado contempla credenciales y retos OTP/push, selección de método y QR raster acotado. Los retos por script, OAuth, CAPTCHA o multicontrato no están implementados y producen un error seguro; puede solicitar un enlace nuevo desde Clientes.
El panel requiere sesión autenticada. Cargar el estado, volver de la ventana del banco y actualizar el historial no envía verificaciones al banco: sólo el envío explícito del formulario realiza una consulta potencialmente facturable.
Mantenga la api_key en su servidor y no registre credenciales, tokens bancarios ni nombres completos en logs de integración innecesarios. Utilice SESSION para soporte y respete la distinción entre veredicto, error y estado de configuración.

Última actualización 2026-10-13