MyBankMatch

Ullmhaigh an ceangal

1. Bíodh ceadúnas gníomhach agat leis an táirge MY_BANK_MATCH agus cuóta ar fáil.
2. Oscail Cliaint · MyBankMatch le do sheisiún fíordheimhnithe agus leis an gceadúnas cuí.
3. Cliceáil Connect bank agus críochnaigh an fíordheimhniú san fhuinneog a óstálann Wealthreader. Nasctar an ceangal tokenaithe le do api_key; ní thugtar token an bhainc don bhrabhsálaí agus ní paraiméadar iarratais é.
4. Nuashonraigh an stádas sa rannán Cliaint. Má éilíonn an banc fíordheimhniú arís, úsáid Reconnect. Cuireann an painéal tástáil shainráite IBAN/ainm ar fáil freisin, chomh maith leis na fiosruithe is déanaí agus iad masctha.

Úsáideann an t-eisitheoir nasc sínithe aon-úsáide agus leanúint atá ceangailte leis an mbrabhsálaí. Má tá an nasc imithe in éag nó má chailltear an leanúint sin, iarr nasc eile ón rannán Cliaint.

Seol fiosrú ón backend

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

Ní sheoltar JSON agus ní úsáidtear X-API-Key: is cuid den chorp ionchódaithe mar fhoirm í an eochair, díreach mar atá 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.'

Is ionadchoinneálaí é <SU_API_KEY>, ní eochair inúsáidte. Léiríonn an IBAN agus an t-ainm iarratas na tástála glactha; níor deimhníodh anseo go dtugann siad breithiúnas áirithe. D'fhéadfadh táille a bheith ar an bhfiosrú: ná seol é mar athnuachan uathoibríoch den chomhéadan.

Tugann MyBankMatch breithiúnas an bhainc ar ais. Ní chuireann sé ríomh áitiúil ar chosúlacht ainmneacha in ionad an fhreagra sin. Ní chruthaíonn, ní údaraíonn ná ní fhorghníomhaíonn sé ordú íocaíochta ach oiread.

Léirmhíniú ar an bhfreagra

Ciallaíonn HTTP 200 go bhfuarthas toradh ón táirge, ní hionann sin agus go dtagann an t-ainm leis go cinnte. Seiceáil success agus ansin payload.result.

Sampla léiritheach de mheaitseáil pháirteach (ainm agus SESSION samhlaithe):

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

Aithníonn statistics.SESSION an fiosrú seo chun críocha diagnóise agus sloinntear execution_time i soicindí. Ní chuimsíonn freagra ceart réad error agus ní thugann sé token an cheangail bhainc ar ais.

I gcás meaitseála páirtí, taispeáin an t-ainm a iontráladh agus suggested_name ar leith; ná cuir an dara ceann in ionad an chéad cheann gan fhios. Má thaispeánann tú in HTML iad, déan iad a éalú mar théacs.

Is é seo an URL socraithe do NOT_CONFIGURED agus REAUTH_REQUIRED:

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

Mar shampla, d'fhéadfadh athfhíordheimhniú an payload seo a thabhairt ar ais:

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

Ní mór do reason_code a bheith ina shlánuimhir idir 2000 agus 2999; mar shampla, freagraíonn 2000 do theip ar dhintiúir. Athcheangail ón rannán Cliaint in ionad an fíorú a athdhéanamh gan stad.

D'fhéadfadh NOT_POSSIBLE a bheith mar thoradh ar mhí-infhaighteacht shealadach, freagra neamhbhailí ón mbanc, easpa IBAN íocóra inúsáidte nó oiriúnóir nach bhfuil ar fáil. Coinnigh reason le haghaidh diagnóise, ach ná déan dearbhú úinéireachta ná meaitseáil dhiúltach de na cásanna sin.

Bailíochtú, cuóta agus earráidí

Leanann earráidí bailíochtaithe nó ceadúnais an clúdach caighdeánach: success: false, payload, error.code, error.message agus statistics le SESSION, fad agus rabhaidh. Freagraíonn bailíochtuithe rialaithe le HTTP 400; d'fhéadfadh faisnéis dhiagnóiseach a bheith sa teachtaireacht agus níor cheart í a úsáid mar aitheantóir cobhsaí.

Ní ídíonn earráidí ionchuir ná torthaí neamhchinntitheacha cuóta na bhfiosruithe inmhuirearaithe. Ídítear an cuóta nuair a thugann an banc MATCH, PARTIAL_MATCH nó NO_MATCH ar ais; má ídíonn glao comhthráthach eile é, tugtar an earráid teorann ar ais in ionad an toradh a dhearbhú mar cheart.

Ní bhaineann an praghas 0,10 EUR ach leis na trí thoradh chinntitheacha sa chonradh. Tá an mód billeála in aghaidh an fhiosraithe agus eisiamh na seisiún nasctha fíoraithe curtha i bhfeidhm, ach teastaíonn an scéimre réamhriachtanach uathu, agus caithfidh oibreoir na fiosruithe billeála a ghníomhachtú agus a athbhreithniú; ní dheimhníonn an leathanach seo go bhfuil sin imscartha. Ní cheadaíonn ach ceangal fíoraithe ar an bhfreastalaí seisiún a eisiamh ón ríomh caighdeánach dintiúr/táirgí: ní leor operation_id ón mbrabhsálaí. Níl díolúine uathoibríoch ag iarrachtaí atá imithe in éag, nach bhfuil iniúchta nó atá stairiúil gan an bunús sin, agus ní ráthaítear aon éifeachtaí saor in aisce eile ar an áiritheoir.

Teorainneacha an leagain seo

• Úsáideann an fíorú ceangal tokenaithe an chliaint féin le Santander do dhaoine aonair. Níor bailíochtaíodh an chomhoiriúnacht bhaincéireachta iarbhír go fóill, agus ní ráthaítear infhaighteacht tráchtála toisc an leathanach seo a fhoilsiú.
• Tacaíonn an sreabhadh óstáilte le dintiúir agus le dúshláin OTP/push, roghnú modha agus QR rastar teoranta. Níl dúshláin script, OAuth, CAPTCHA ná ilchonartha curtha i bhfeidhm agus tugann siad earráid shlán; is féidir leat nasc nua a iarraidh ón rannán Cliaint.
• Teastaíonn seisiún fíordheimhnithe ón bpainéal. Ní sheolann luchtú an stádais, filleadh ó fhuinneog an bhainc ná nuashonrú na staire fíoruithe chuig an mbanc: ní dhéanann ach seoladh sainráite na foirme fiosrú a d'fhéadfadh a bheith inmhuirearaithe.
• Coinnigh an api_key ar do fhreastalaí agus ná logáil dintiúir, tokens bainc ná ainmneacha iomlána i logaí comhtháthaithe nach bhfuil gá leo. Úsáid SESSION le haghaidh tacaíochta agus coinnigh an t-idirdhealú idir breithiúnas, earráid agus staid chumraíochta.