Íocaíochtaí le Wealth Reader

Ailtireacht in dhá chéim

Leanann comhtháthú íocaíochta deighilt dhian na bhfreagrachtaí in dhá chéim:

sequenceDiagram
autonumber
actor Usuario as Úsáideoir
participant Front as Frontend (Tráchtáil)
participant Back as Inneall (Tráchtáil)
participant API as API Wealth Reader
participant Widget as Íocaíochtaí Giuirléidí
participant Banco as Banc (SCA)
Note over Back,API: An chéim roimhe seo (próifílí bhainistithe amháin)
Back->>API: POST /payments/?action=profile-institutions
API-->>Back: Catalóg Próifíle (institution_code)
Note over Back,API: Céim 1: An Intinn Do-Athraithe a Chruthú (Freastalaí-go-Freastalaí)
Back->>API: POST /payments/?action=create (le X-API-Key agus Idempotency-Key)
API-->>Back: 201 le payment.id + payment.widget.token gearrshaolta
Note over Front,Widget: Céim 2: Luchtú agus Údarú sa ghiuirléid (Brabhsálaí)
Back->>Front: Seachadadh payment.id agus payment.widget.token
Front->>Widget: WealthReaderPayments.mount(...) nó load-payments.js
Widget->>Usuario: Tá eintiteas, méid agus coincheap do-athraithe aige
Usuario->>Widget: Údaraigh íocaíocht
Widget->>Banco: Atreorú / Aip go Aip (SCA)
Banco->>API: An SCA a thabhairt ar ais chuig callback Wealth Reader
API-->>Widget: Dearbhú teicniúil an údaraithe
Note over Back,API: Athmhuintearas agus Daingniú Airgeadais
loop Go dtí stádas deiridh
Back->>API: POST /payments/?action=status
API-->>Back: payment_status: not_initiated | pending | settled | ...
end

1. Céim 1 (Inneall Slán): Cruthaíonn do fhreastalaí intinn íocaíochta (POST /payments/?action=create) le do X-API-Key, Idempotency-Key agus Content-Type: application/json. Sa ghlao seo, socraítear an méid (amount_minor, i cents), an t-airgeadra (currency, inniu ach EUR), an tairbhí (beneficiary.name agus beneficiary.iban), coincheap an ráitis (reference), a thagairt inmheánach (customer_reference) agus an tionscnamh gréasáin ceadaithe (allowed_origin). Tá na sé réimse sin éigeantach, agus is liosta bán docht é an corp: filleann aon réimse neamhaitheanta 422 invalid_request.
2. Freagra: 201 le {"success": true, "payment": {…}} - nó 200 más athrá idempotent é. Tagann an ID intinne i payment.id agus token gearrshaolta an ghiuirléid i payment.widget.token.
3. Céim 2 (Frontend na trádála): Cuireann an brabhsálaí an ghiuirléid ag baint úsáide as an script oifigiúil load-payments.js nó an fheidhm WealthReaderPayments.mount(), gan ach an payment.id agus an payment.widget.tokena sheachadadh. Roghnaíonn an t-úsáideoir a mbanc (mura raibh sé réamhroghnaithe san intinn) agus comhlánaíonn sé an fíordheimhniú láidir (SCA) sa chomhéadan baincéireachta.
4. Dearbhú airgeadais: Seiceálann do backend stádas na híocaíochta ag baint úsáide as POST /payments/?action=status, a bhfuil a chorp díreach {"payment_intent_id": "<id>"}. Gan aon webhook: Seiceálann sé an stádas go tréimhsiúil go dtí go sroicheann sé stát teirminéil.

Dhá mhúnla íocaíochta

Tacaíonn Wealth Reader dhá mhúnla ag brath ar riachtanais an ghnó:

1. Comhtháthú caighdeánach do cheannaithe (Tairbhí féin):
   • Sainmhíníonn an ceannaí ainm agus IBAN an tairbhí, an méid, an t-airgeadra (EUR), an coincheap agus a thagairt ordaithe faoi shaoirse.
   • Is féidir leat scagadh a dhéanamh ar na bainc a chur ar fáil don úsáideoir ag baint úsáide as allowed_institution_codes nó an chatalóg iomlán a cheadú.
2. Próifílí bainistithe (mar shampla cruz_roja_demo):
   • Deartha le haghaidh síntiúis agus taispeántais phoiblí.
   • Socraíonn an freastalaí na cuntais scríbe oifigiúla chun a chinntiú nach féidir na cistí a dhíriú ach chuig an gcarthanas (mar shampla, Cros Dhearg na Spáinne le méideanna idir 0,01 EUR agus 1,00 EUR).

Eolaire aontaithe d'eintitis bhaincéireachta

Soláthraíonn Wealth Reader catalóg aontaithe d'eintitis Eorpacha atá ullmhaithe le haghaidh tionscnaimh íocaíochta trí PSD2 trí:

• GET https://api.wealthreader.com/payments/entities/?country=ES

Ligeann sé duit liosta na mbanc a fháil lena n-ainmneacha caighdeánaithe, lógónna, modhanna aistrithe tacaithe agus riachtanais theicniúla (mar shampla an gá le IBAN an fhéichiúnaí a iarraidh ón íocóir). Tacaíonn sé leis na scagairí country, search (ailias q), code, payment_method, limit agus offset.

Tá an críochphointe seo poiblí: ní theastaíonn X-API-Keyuaidh. Ní chuireann sé rud ar bith agus ídíonn sé glao ó do chuóta paschód.

Bain úsáid as na cóid seo i gcónaí de réir mar a thagann siad isteach code. Bailíochtaíonn cruthú an intinn an fhormáidiú allowed_institution_codes, ach ní sheiceálann sé go bhfuil siad sa chatalóg: ní theipeann ar chód mílitrithe nuair a chruthaítear é agus tá sé le feiceáil ina dhiaidh sin mar phiocóir bainc folamh.

Freagrachtaí a dheighilt

• Ní úsáidtear an eochair rochtana íocaíochta (X-API-Key) ach amháin ó fhreastalaí go freastalaí. Níor chóir í a chur san áireamh riamh i stórtha tosaigh nó poiblí.
• Ní fhaigheann an brabhsálaí ach aitheantóir na hintinne agus token ghearrshaolach gearrshaolach ceangailte leis an mbunús HTTPS.
• Ní féidir leis an ngiuirléid an méid, an t-airgeadra, an tairbhí, an coincheap nó na hinstitiúidí údaraithe a athrú.
• Ní hionann an modal nó an ghiuirléid a dhúnadh in ionad an ráitis airgeadais a cheistiú sa backend.
• Ní roinneann íocaíochtaí eochracha rochtana, comharthaí, nó glaonna siar le táirge comhiomlánaithe bainc Wealth Reader.

Dintiúir agus cuóta

Ní mór PAYMENTS an táirge a chumasú do phaseochair íocaíochtaí; mura bhfuil, freagraíonn an API 403 payments_not_allowed. Filleann paseochair atá in easnamh nó formáidithe go mícheart 401 invalid_api_key.

An chéad chéim eile

Lean ar aghaidh leis Comhtháthú agus giuirléid.