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.
Desarrolladores
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.
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"
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": []
}
}
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"
}
}
Parámetros, resultados y errores de POST /my-bank-match/. El detalle completo está en la guía de integración.
| Parámetro | Validación |
|---|---|
api_key | Su clave de API, con el producto MyBankMatch activo y cuota disponible. |
iban | IBAN 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. |
name | Nombre de la persona o empresa que dice ser titular, de hasta 140 caracteres. |
result | Significado | Consume cuota | Campos 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ódigo de error | Significado |
|---|---|
2 | Llamada incorrecta: método, clave de API, producto no activo o límite de llamadas. |
4000 | IBAN no válido. |
4001 | Nombre del titular no válido. |
1 | Error interno. |
Los errores no se cobran ni consumen cuota.
Si ya usa la API de Wealthreader, MyBankMatch responde con la misma estructura y los mismos hábitos de integración.
El IBAN y el nombre se validan antes de consultar al banco: un dato mal formado devuelve un error al instante.
MATCH, PARTIAL_MATCH y NO_MATCH consumen cuota. Las consultas que no llegan a una conclusión, no.
La guía paso a paso y la referencia de la API describen el contrato completo, con ejemplos.
Abrir la guía de MyBankMatch (se abre en una pestaña nueva) Abrir la referencia de la API (se abre en una pestaña nueva) Solicitar acceso
Le mostramos MyBankMatch con los pagos y las altas de su negocio.