MyBankMatch

Preparar la connexió

1. Disposeu d'una llicència activa amb el producte MY_BANK_MATCH i quota disponible.
2. Obriu Clients · MyBankMatch amb la vostra sessió autenticada i la llicència corresponent.
3. Feu clic a Connect bank i completeu l'autenticació a la finestra allotjada per Wealthreader. La connexió tokenitzada queda associada a la vostra api_key; el token bancari no es lliura al navegador ni és un paràmetre de consulta.
4. Actualitzeu l'estat a Clients. Si el banc requereix que us torneu a autenticar, utilitzeu Reconnect. El tauler també ofereix una prova explícita d'IBAN/nom i les darreres consultes emmascarades.

L'emissor utilitza un enllaç signat d'un sol ús i una continuació lligada al navegador. Si l'enllaç ha caducat o perd aquesta continuació, sol·liciteu-ne un altre des de Clients.

Enviar una consulta des del backend

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

No s'envia JSON ni s'utilitza X-API-Key: la clau forma part del cos codificat com a formulari, igual que a /entities/.

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=Wealthreader S.L.'

<SU_API_KEY> és un marcador, no una clau utilitzable. L'IBAN i el nom il·lustren la sol·licitud d'acceptació; no s'ha comprovat aquí que produeixin un veredicte concret. La consulta pot ser facturable: no la llanceu com un refresc automàtic de la interfície.

MyBankMatch retorna el veredicte del banc. No substitueix aquesta resposta per un càlcul local de similitud de noms. Tampoc crea, autoritza ni executa cap ordre de pagament.

Interpretar la resposta

HTTP 200 indica que s'ha obtingut un resultat del producte, no que el nom coincideixi necessàriament. Comproveu success i després payload.result.

Exemple il·lustratiu de coincidència parcial (nom i SESSION simulats):

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

statistics.SESSION identifica aquesta consulta per al diagnòstic i execution_time s'expressa en segons. Una resposta correcta no inclou cap objecte error ni retorna el token de la connexió bancària.

En una coincidència parcial, mostreu per separat el nom introduït i suggested_name; no substituïu silenciosament el primer. Si els presenteu en HTML, escapeu-los com a text.

La URL de preparació de NOT_CONFIGURED i REAUTH_REQUIRED és:

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

Per exemple, una reautenticació pot retornar aquest payload:

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

reason_code ha de ser un enter entre 2000 i 2999; per exemple, 2000 correspon a un error de credencials. Torneu a connectar des de Clients en lloc de repetir indefinidament la verificació.

NOT_POSSIBLE es pot deure a una indisponibilitat transitòria, una resposta bancària no vàlida, la manca d'un IBAN pagador utilitzable o un adaptador no disponible. Conserveu reason per al diagnòstic, però no convertiu aquests casos en una confirmació de titularitat ni en una coincidència negativa.

Validació, quota i errors

Els errors de validació o de llicència segueixen el sobre habitual: success: false, payload, error.code, error.message i statistics amb SESSION, durada i avisos. Les validacions controlades responen HTTP 400; el missatge pot incloure informació de diagnòstic i no s'ha d'utilitzar com a identificador estable.

Els errors d'entrada i els resultats no concloents no consumeixen la quota de consultes facturables. La quota es consumeix quan el banc retorna MATCH, PARTIAL_MATCH o NO_MATCH; si una altra crida l'esgota simultàniament, es retorna l'error de límit en lloc de confirmar el resultat com a correcte.

El preu de 0,10 EUR correspon únicament als tres resultats concloents del contracte. El mode de facturació per consulta i l'exclusió de sessions de vinculació verificades estan implementats, però requereixen l'esquema previ i l'activació/revisió de les consultes de facturació per part d'un operador; aquesta pàgina no acredita aquest desplegament. Només una associació verificada al servidor permet excloure una sessió del càlcul estàndard de credencials/productes: amb un operation_id del navegador no n'hi ha prou. Els intents caducats, no auditats o històrics sense aquesta procedència no tenen exempció automàtica, ni es garanteixen altres efectes de comptador gratuïts.

Límits d'aquesta versió

• La verificació utilitza la connexió pròpia tokenitzada del client amb Santander particulars. Encara no s'ha validat la compatibilitat bancària real ni es garanteix la disponibilitat comercial pel fet de publicar aquesta pàgina.
• El flux allotjat contempla credencials i reptes OTP/push, selecció de mètode i QR ràster acotat. Els reptes per script, OAuth, CAPTCHA o multicontracte no estan implementats i produeixen un error segur; podeu sol·licitar un enllaç nou des de Clients.
• El tauler requereix una sessió autenticada. Carregar l'estat, tornar de la finestra del banc i actualitzar l'historial no envien verificacions al banc: només l'enviament explícit del formulari fa una consulta potencialment facturable.
• Mantingueu l'api_key al vostre servidor i no registreu credencials, tokens bancaris ni noms complets en registres d'integració innecessaris. Utilitzeu SESSION per al suport i respecteu la distinció entre veredicte, error i estat de configuració.