MyBankMatch

Pregătirea conexiunii

1. Asigură-te că ai o licență activă cu produsul MY_BANK_MATCH și cotă disponibilă.
2. Deschide Clienți · MyBankMatch cu sesiunea ta autentificată și licența corespunzătoare.
3. Apasă Connect bank și finalizează autentificarea în fereastra găzduită de Wealthreader. Conexiunea tokenizată rămâne asociată cu api_key a ta; tokenul bancar nu este transmis browserului și nici nu este un parametru de interogare.
4. Actualizează starea în Clienți. Dacă banca solicită o nouă autentificare, folosește Reconnect. Panoul oferă și un test explicit de IBAN/nume și ultimele interogări mascate.

Emitentul folosește un link semnat de unică folosință și o continuare legată de browser. Dacă linkul a expirat sau se pierde această continuare, solicită altul din Clienți.

Trimiterea unei interogări din backend

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

Nu se trimite JSON și nu se folosește X-API-Key: cheia face parte din corpul codificat ca formular, la fel ca în /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> este un marcaj substituent, nu o cheie utilizabilă. IBAN-ul și numele ilustrează cererea de acceptare; aici nu s-a verificat că produc un verdict concret. Interogarea poate fi facturabilă: nu o lansa ca reîmprospătare automată a interfeței.

MyBankMatch returnează verdictul băncii. Nu înlocuiește acest răspuns cu un calcul local de similaritate a numelor. De asemenea, nu creează, nu autorizează și nu execută un ordin de plată.

Interpretarea răspunsului

HTTP 200 indică faptul că s-a obținut un rezultat al produsului, nu că numele coincide neapărat. Verifică success și apoi payload.result.

Exemplu ilustrativ de potrivire parțială (nume și SESSION simulate):

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

statistics.SESSION identifică această interogare în scop de diagnosticare, iar execution_time este exprimat în secunde. Un răspuns corect nu include un obiect error și nu returnează tokenul conexiunii bancare.

În cazul unei potriviri parțiale, afișează separat numele introdus și suggested_name; nu înlocui în mod tacit primul nume. Dacă le prezinți în HTML, aplică-le escaparea ca text.

URL-ul de pregătire pentru NOT_CONFIGURED și REAUTH_REQUIRED este:

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

De exemplu, o reautentificare poate returna acest payload:

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

reason_code trebuie să fie un număr întreg între 2000 și 2999; de exemplu, 2000 corespunde unei erori de credențiale. Reconectează-te din Clienți în loc să repeți verificarea la nesfârșit.

NOT_POSSIBLE se poate datora unei indisponibilități temporare, unui răspuns bancar nevalid, lipsei unui IBAN plătitor utilizabil sau unui adaptor indisponibil. Păstrează reason pentru diagnosticare, dar nu transforma aceste cazuri într-o confirmare a titularității și nici într-o potrivire negativă.

Validare, cotă și erori

Erorile de validare sau de licență urmează structura obișnuită a răspunsului: success: false, payload, error.code, error.message și statistics cu SESSION, durata și avertismentele. Validările controlate răspund cu HTTP 400; mesajul poate include informații de diagnosticare și nu trebuie folosit ca identificator stabil.

Erorile de intrare și rezultatele neconcludente nu consumă cota de interogări facturabile. Cota se consumă atunci când banca returnează MATCH, PARTIAL_MATCH sau NO_MATCH; dacă un alt apel o epuizează simultan, se returnează eroarea de limită în loc să se confirme rezultatul ca fiind corect.

Prețul de 0,10 EUR corespunde exclusiv celor trei rezultate concludente din contract. Modul de facturare per interogare și excluderea sesiunilor de asociere verificate sunt implementate, dar necesită schema prealabilă și activarea/revizuirea interogărilor de facturare de către un operator; această pagină nu atestă această implementare. Doar o asociere verificată de server permite excluderea unei sesiuni din calculul standard de credențiale/produse: un operation_id din browser nu este suficient. Încercările expirate, neauditate sau istorice fără această proveniență nu beneficiază de scutire automată și nici nu sunt garantate alte efecte gratuite asupra contorului.

Limitele acestei versiuni

• Verificarea folosește conexiunea tokenizată proprie a clientului cu Santander persoane fizice. Compatibilitatea bancară reală nu a fost încă validată, iar publicarea acestei pagini nu garantează disponibilitatea comercială.
• Fluxul găzduit acceptă credențiale și provocări OTP/push, selectarea metodei și cod QR raster limitat. Provocările prin script, OAuth, CAPTCHA sau multicontract nu sunt implementate și produc o eroare sigură; poți solicita un link nou din Clienți.
• Panoul necesită o sesiune autentificată. Încărcarea stării, revenirea din fereastra băncii și actualizarea istoricului nu trimit verificări către bancă: doar trimiterea explicită a formularului efectuează o interogare potențial facturabilă.
• Păstrează api_key pe serverul tău și nu înregistra credențiale, tokenuri bancare sau nume complete în loguri de integrare inutile. Folosește SESSION pentru suport și respectă distincția dintre verdict, eroare și starea configurației.