MyBankMatch

Preparare la connessione

1. Disponi di una licenza attiva con il prodotto MY_BANK_MATCH e quota disponibile.
2. Apri Clienti · MyBankMatch con la tua sessione autenticata e la licenza corrispondente.
3. Fai clic su Connect bank e completa l'autenticazione nella finestra ospitata da Wealthreader. La connessione tokenizzata resta associata alla tua api_key; il token bancario non viene consegnato al browser né è un parametro di query.
4. Aggiorna lo stato in Clienti. Se la banca richiede una nuova autenticazione, usa Reconnect. Il pannello offre anche una prova esplicita di IBAN/nome e le ultime consultazioni mascherate.

L'emittente utilizza un link firmato monouso e una continuazione legata al browser. Se il link è scaduto o perdi quella continuazione, richiedine un altro da Clienti.

Inviare una consultazione dal backend

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

Non si invia JSON né si usa X-API-Key: la chiave fa parte del corpo codificato come modulo, come in /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> è un segnaposto, non una chiave utilizzabile. L'IBAN e il nome illustrano la richiesta di accettazione; qui non è stato verificato che producano un verdetto specifico. La consultazione può essere fatturabile: non lanciarla come aggiornamento automatico dell'interfaccia.

MyBankMatch restituisce il verdetto della banca. Non sostituisce quella risposta con un calcolo locale di somiglianza dei nomi. Inoltre non crea, non autorizza né esegue un ordine di pagamento.

Interpretare la risposta

HTTP 200 indica che è stato ottenuto un risultato del prodotto, non che il nome corrisponda necessariamente. Controlla success e poi payload.result.

Esempio illustrativo di corrispondenza parziale (nome e SESSION simulati):

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

statistics.SESSION identifica questa consultazione a fini diagnostici e execution_time è espresso in secondi. Una risposta corretta non include un oggetto error né restituisce il token della connessione bancaria.

In caso di corrispondenza parziale, mostra separatamente il nome inserito e suggested_name; non sostituire silenziosamente il primo. Se li presenti in HTML, applica l'escape come testo.

L'URL di preparazione per NOT_CONFIGURED e REAUTH_REQUIRED è:

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

Ad esempio, una nuova autenticazione può restituire questo payload:

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

reason_code deve essere un intero compreso tra 2000 e 2999; ad esempio, 2000 corrisponde a un errore delle credenziali. Riconnettiti da Clienti invece di ripetere la verifica all'infinito.

NOT_POSSIBLE può dipendere da un'indisponibilità temporanea, da una risposta bancaria non valida, dalla mancanza di un IBAN ordinante utilizzabile o da un adattatore non disponibile. Conserva reason per la diagnosi, ma non trasformare questi casi in una conferma di titolarità né in una corrispondenza negativa.

Validazione, quota ed errori

Gli errori di validazione o di licenza seguono la consueta struttura di risposta: success: false, payload, error.code, error.message e statistics con SESSION, durata e avvisi. Le validazioni controllate rispondono HTTP 400; il messaggio può includere informazioni diagnostiche e non deve essere usato come identificatore stabile.

Gli errori di input e i risultati non conclusivi non consumano la quota di consultazioni fatturabili. La quota viene consumata quando la banca restituisce MATCH, PARTIAL_MATCH o NO_MATCH; se un'altra chiamata la esaurisce in contemporanea, viene restituito l'errore di limite invece di confermare il risultato come corretto.

Il prezzo di 0,10 EUR corrisponde esclusivamente ai tre risultati conclusivi del contratto. La modalità di fatturazione per consultazione e l'esclusione delle sessioni di collegamento verificate sono implementate, ma richiedono lo schema preliminare e l'attivazione/revisione delle query di fatturazione da parte di un operatore; questa pagina non attesta tale distribuzione. Solo un'associazione verificata lato server consente di escludere una sessione dal calcolo standard di credenziali/prodotti: un operation_id del browser non basta. I tentativi scaduti, non verificati o storici privi di tale provenienza non hanno un'esenzione automatica, né sono garantiti altri effetti gratuiti sul contatore.

Limiti di questa versione

• La verifica utilizza la connessione tokenizzata del cliente stesso con Santander privati. La compatibilità bancaria reale non è ancora stata validata e la pubblicazione di questa pagina non garantisce la disponibilità commerciale.
• Il flusso ospitato supporta credenziali e sfide OTP/push, selezione del metodo e QR raster limitato. Le sfide tramite script, OAuth, CAPTCHA o multicontratto non sono implementate e producono un errore sicuro; puoi richiedere un nuovo link da Clienti.
• Il pannello richiede una sessione autenticata. Caricare lo stato, tornare dalla finestra della banca e aggiornare lo storico non invia verifiche alla banca: solo l'invio esplicito del modulo esegue una consultazione potenzialmente fatturabile.
• Conserva la api_key sul tuo server e non registrare credenziali, token bancari né nomi completi in log di integrazione non necessari. Usa SESSION per l'assistenza e rispetta la distinzione tra verdetto, errore e stato di configurazione.