MyBankMatch

Yhteyden valmistelu

1. Varmista, että sinulla on aktiivinen lisenssi, jossa on tuote MY_BANK_MATCH ja käytettävissä olevaa kiintiötä.
2. Avaa Asiakkaat · MyBankMatch tunnistautuneella istunnolla ja vastaavalla lisenssillä.
3. Napsauta Connect bank ja suorita tunnistautuminen Wealthreaderin isännöimässä ikkunassa. Tokenisoitu yhteys liitetään api_key-avaimeesi; pankkitokenia ei luovuteta selaimelle, eikä se ole kyselyparametri.
4. Päivitä tila Asiakkaat-osiossa. Jos pankki vaatii uuden tunnistautumisen, käytä Reconnect-painiketta. Paneelissa on myös erillinen IBAN-/nimitesti ja viimeisimmät peitetyt kyselyt.

Myöntäjä käyttää kertakäyttöistä allekirjoitettua linkkiä ja selaimeen sidottua jatkotilaa. Jos linkki on vanhentunut tai jatkotila katoaa, pyydä uusi linkki Asiakkaat-osiosta.

Kyselyn lähettäminen taustajärjestelmästä

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

JSONia ei lähetetä eikä X-API-Key-otsaketta käytetä: avain on osa lomakemuotoon koodattua runkoa, kuten /entities/-päätepisteessä.

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> on paikkamerkki, ei käyttökelpoinen avain. IBAN ja nimi havainnollistavat hyväksymistestin pyyntöä; tässä ei ole varmistettu, että ne tuottavat tietyn ratkaisun. Kysely voi olla laskutettava: älä käynnistä sitä käyttöliittymän automaattisena päivityksenä.

MyBankMatch palauttaa pankin ratkaisun. Se ei korvaa tätä vastausta paikallisella nimien samankaltaisuuslaskelmalla. Se ei myöskään luo, valtuuta eikä toteuta maksumääräystä.

Vastauksen tulkinta

HTTP 200 tarkoittaa, että tuotteesta on saatu tulos, ei sitä, että nimi välttämättä täsmää. Tarkista success ja sen jälkeen payload.result.

Havainnollistava esimerkki osittaisesta vastaavuudesta (nimi ja SESSION ovat keksittyjä):

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

statistics.SESSION yksilöi tämän kyselyn vianmääritystä varten, ja execution_time ilmoitetaan sekunteina. Onnistunut vastaus ei sisällä error-objektia eikä palauta pankkiyhteyden tokenia.

Osittaisessa vastaavuudessa näytä syötetty nimi ja suggested_name erikseen; älä korvaa ensin mainittua huomaamatta. Jos näytät ne HTML:ssä, käsittele ne tekstinä ja suojaa erikoismerkit.

Tulosten NOT_CONFIGURED ja REAUTH_REQUIRED määritys-URL on:

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

Esimerkiksi uudelleentunnistautuminen voi palauttaa tämän payload-objektin:

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

reason_code-arvon on oltava kokonaisluku väliltä 2000–2999; esimerkiksi 2000 tarkoittaa tunnistetietovirhettä. Yhdistä uudelleen Asiakkaat-osiosta sen sijaan, että toistaisit varmennusta loputtomasti.

NOT_POSSIBLE voi johtua tilapäisestä käyttökatkosta, virheellisestä pankin vastauksesta, käyttökelpoisen maksajan IBANin puuttumisesta tai siitä, ettei sovitin ole käytettävissä. Säilytä reason vianmääritystä varten, mutta älä tulkitse näitä tapauksia omistajuuden vahvistukseksi tai kielteiseksi vastaavuudeksi.

Validointi, kiintiö ja virheet

Validointi- ja lisenssivirheet noudattavat tavallista vastausrakennetta: success: false, payload, error.code, error.message ja statistics, jossa on SESSION, kesto ja varoitukset. Hallitut validoinnit vastaavat HTTP 400 -tilakoodilla; viesti voi sisältää vianmääritystietoja, eikä sitä pidä käyttää pysyvänä tunnisteena.

Syötevirheet ja epäselvät tulokset eivät kuluta laskutettavien kyselyjen kiintiötä. Kiintiötä kuluu, kun pankki palauttaa MATCH, PARTIAL_MATCH tai NO_MATCH; jos toinen samanaikainen kutsu kuluttaa sen loppuun, palautetaan rajavirhe sen sijaan, että tulos vahvistettaisiin onnistuneeksi.

0,10 EUR:n hinta koskee vain sopimuksen kolmea yksiselitteistä tulosta. Kyselykohtainen laskutustila ja varmennettujen liittämisistuntojen poissulkeminen on toteutettu, mutta ne edellyttävät etukäteen luotua skeemaa sekä sitä, että operaattori aktivoi ja tarkistaa laskutuskyselyt; tämä sivu ei todista, että käyttöönotto on tehty. Vain varmennettu palvelinpuolen liitos mahdollistaa istunnon poissulkemisen tunnistetietojen/tuotteiden vakiolaskennasta: selaimen operation_id ei riitä. Vanhentuneet, auditoimattomat tai historialliset yritykset, joilla ei ole tällaista alkuperää, eivät saa automaattista vapautusta, eikä muita maksuttomia laskurivaikutuksia taata.

Tämän version rajoitukset

• Varmennus käyttää asiakkaan omaa tokenisoitua yhteyttä Santanderin yksityisasiakaspalveluun. Todellista pankkiyhteensopivuutta ei ole vielä validoitu, eikä tämän sivun julkaiseminen takaa kaupallista saatavuutta.
• Isännöity prosessi tukee tunnistetietoja ja OTP-/push-haasteita, menetelmän valintaa ja rajattua rasteri-QR-koodia. Skripti-, OAuth-, CAPTCHA- tai monisopimushaasteita ei ole toteutettu, ja ne tuottavat turvallisen virheen; voit pyytää uuden linkin Asiakkaat-osiosta.
• Paneeli vaatii tunnistautuneen istunnon. Tilan lataaminen, paluu pankin ikkunasta ja historian päivittäminen eivät lähetä varmennuksia pankille: vain lomakkeen nimenomainen lähettäminen tekee mahdollisesti laskutettavan kyselyn.
• Säilytä api_key palvelimellasi äläkä kirjaa tunnistetietoja, pankkitokeneita tai täydellisiä nimiä tarpeettomiin integraatiolokeihin. Käytä SESSION-tunnistetta tukiasioissa ja pidä erillään ratkaisu, virhe ja määritystila.