Desarrolladores

Una API. Un veredicto por cuenta.

MyBankMatch es un punto de la API de Wealthreader: HTTPS, parámetros de formulario y respuesta JSON. Envíe el IBAN y el nombre, y reciba el resultado de la verificación.

Para activar el servicio vinculamos una sola vez una cuenta de su empresa desde el panel de Clientes de Wealthreader: es la que realiza las consultas de Verificación del Beneficiario. Sus clientes y proveedores no tienen que hacer nada.

  1. Envíe IBAN y nombre

    Una petición POST con su clave de API, el IBAN de la cuenta y el nombre de la persona o empresa que dice ser su titular.

    curl https://api.wealthreader.com/my-bank-match/ \
      -d api_key=$API_KEY \
      -d iban=ES9121000418450200051332 \
      --data-urlencode name="Talleres Ruiz SL"
  2. Reciba el resultado

    La respuesta llega en la misma llamada, con el mismo sobre que el resto de la API: success, payload y statistics.

    {
      "success": true,
      "payload": {
        "result": "MATCH"
      },
      "statistics": {
        "SESSION": "…",
        "execution_time": 1.84,
        "warnings": []
      }
    }
  3. Coincidencia parcial: nombre sugerido

    Si el nombre se parece pero no es idéntico, la respuesta incluye suggested_name con el nombre que consta en el banco.

    Los valores son ilustrativos.

    {
      "success": true,
      "payload": {
        "result": "PARTIAL_MATCH",
        "suggested_name": "Talleres Ruiz Martínez SL"
      }
    }

Referencia rápida

Parámetros, resultados y errores de POST /my-bank-match/. El detalle completo está en la guía de integración.

Parámetros de la petición
ParámetroValidación
api_keySu clave de API, con el producto MyBankMatch activo y cuota disponible.
ibanIBAN de un país SEPA. Se ignoran espacios y mayúsculas; se comprueban la longitud de su país y los dígitos de control.
nameNombre de la persona o empresa que dice ser titular, de hasta 140 caracteres.
Valores de result
resultSignificadoConsume cuotaCampos adicionales
MATCH El nombre coincide con el titular de la cuenta. Sí —
PARTIAL_MATCH El nombre se parece al del titular; suggested_name trae el nombre que consta en el banco. Sí suggested_name
NO_MATCH El nombre no corresponde al titular de la cuenta. Sí —
NOT_CONFIGURED Su clave aún no tiene una cuenta vinculada; setup_url lleva a la vinculación. No setup_url
REAUTH_REQUIRED El banco vinculado pide volver a autenticarse; setup_url lleva a la reconexión. No setup_url, reason_code
NOT_POSSIBLE El banco no ha podido verificar la cuenta en este momento; reason indica el motivo. No reason
Códigos de error
Código de errorSignificado
2Llamada incorrecta: método, clave de API, producto no activo o límite de llamadas.
4000IBAN no válido.
4001Nombre del titular no válido.
1Error interno.

Los errores no se cobran ni consumen cuota.

Detalles de integración

El mismo sobre de siempre

Si ya usa la API de Wealthreader, MyBankMatch responde con la misma estructura y los mismos hábitos de integración.

Validación antes del banco

El IBAN y el nombre se validan antes de consultar al banco: un dato mal formado devuelve un error al instante.

Solo paga lo concluyente

MATCH, PARTIAL_MATCH y NO_MATCH consumen cuota. Las consultas que no llegan a una conclusión, no.

Documentación pública

La guía paso a paso y la referencia de la API describen el contrato completo, con ejemplos.

Antes de enviar el dinero, compruebe a quién

Le mostramos MyBankMatch con los pagos y las altas de su negocio.

Solicitar una demo