IframeCéim 2 de 2

Socraigh an inneall

Faigh na sonraí bainc normalaithe ar do fhreastalaí agus deimhnigh an callbacki gceart.

Comhlánaigh an Seicliosta Frontend. Ní sheolann an ghiuirléid sonraí bainc faoi postMessage- seolann sé anseo iad, ag baint úsáide as POST.

Seicliosta comhtháthaithe

0 as 4

Cruthaigh an URL callback
Comhlach fearainn, callback , agus api_key
Déan tástáil ar an sreabhadh le húsáideoir tástála
Sábháil operation_id, token agus statistics.code

1. Cruthaigh an URL callback

Nochtann críochphointe HTTPS ar do fhreastalaí a ghlacann le POST le JSONchoirp.

Tar éis an méid is gá a phróiseáil, freagair HTTP 200 leis na JSONseo a leanas:

{
    "status": "ok"
}

Má thugann tú cód stádais eile nó JSON eile ar ais, ní chuirfidh an ghiuirléid in iúl don frontend gur chríochnaigh an sreabhadh go rathúil.

Déileáil le operation_id mar idempotent: Níor chóir go gcruthódh seachadadh arís agus arís eile dhá oibríocht ar do chóras.

2. Cad atá ag teacht sa POST

Tá an corp mar an gcéanna JSON POST /entities/ sa Tagairt OpenAPI. Na rudaí tábhachtacha chun an oibríocht a thrasnú:

Réimse	Feidhmchlár
`success`	`true` dá gcríochnódh an léamh go maith.
`payload`	Sonraí caighdeánaithe (cuntais, sparán, cártaí, etc.).
`statistics.operation_id`	An `operation_id` a ghin do frontend.
`statistics.token`	Dintiúr coimeádta le haghaidh athnuachaintí sonraí ina dhiaidh sin (má tá tokenization gníomhach).
`statistics.code`	Cód eintiteas (`bbva`, `caixabank`, ...).
`statistics.SESSION`	Aitheantas seisiúin, úsáideach i dticéad tacaíochta.
`statistics.warnings`	Rabhaidh nach gcuireann an léamh ó bhail (mar shampla, táirge folamh).

Sampla gearrtha:

{
    "success": true,
    "payload": {
        "user_information": {
            "ID": "12345678Z",
            "name": "LUIS GARCIA BAQUERO"
        },
        "accounts": [
            {
                "uuid": "8076932f04f73e27fe608fee4d12fca8708dec8c",
                "subtype": "checking",
                "code": "ES4914651234561234567890",
                "name": "Cuenta NOMINA",
                "currency": "EUR",
                "balances": {
                    "available": 14302.07,
                    "current": 14302.07
                },
                "transactions": []
            }
        ]
    },
    "statistics": {
        "SESSION": "A1B2C3D4E5F67890",
        "execution_time": 12.4,
        "warnings": [],
        "operation_id": "8f1c2a6e-4b0d-4c3a-9e21-0d5b7a91c4e2",
        "token": "FRJ0mHlaqZwLzu",
        "code": "bbva"
    }
}

Tá an scéimre iomlán payload san OpenAPI. Ná glac leis go dtagann gach eochrach isteach i gcónaí: braitheann siad ar product_types agus ar an méid atá ag an úsáideoir san eintiteas.

3. Comhlach fearainn, callback agus eochair API

Sa Limistéar Custaiméirí Comhlach:

an fearann óna bhfuil an ghiuirléid luchtaithe (bunús do tosaigh);
URL na callback a chruthaigh tú;
do api_key.

Go dtí go bhfuil an fearann cláraithe, ní oibríonn an ghiuirléid.

4. Tástáil an sreabhadh

Oscail an leathanach a luchtaíonn an ghiuirléid agus logáil isteach:

Úsáideoir	Pasfhocal	Toradh
`MOCKDATA`	Aon	Léamh rathúil le sonraí samplacha anaithnidithe. Faigheann an callback JSON `success: true`.
`MOCKOTP`	Aon	Déanann tú dúshlán dhá fhachtóir a athchruthú.
`MOCKLOGINKO`	Aon	Athchruthaíonn tú earráid logála isteach. Ní ghlaotar ar an callback .

Mura bhfuil an ríomhphost fáilte agat, iarr air ag support@wealthreader.com.

Más mian leat an POST a fheiceáil sula mbeidh an críochphointe agat i do thimpeallacht, cruthaigh URL sealadach i seirbhís cosúil le https://pipedream.com/ agus é a chur mar callback.

5. Sonraí a athnuachan (roghnach)

Go dtí seo tá comhtháthú aon-urchar agat: léamh amháin do gach uair a osclaíonn an t-úsáideoir an ghiuirléid.

Má theastaíonn baisc oíche nó cnaipe "nuashonrú" uait, glaoigh ar an API arís leis an token agus code a shábháil tú ón callback. Ná iarr ainm úsáideora agus pasfhocal nua.

curl --location 'https://api.wealthreader.com/entities/' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'api_key=TU_API_KEY' \
  --data-urlencode 'code=bbva' \
  --data-urlencode 'token=EL_TOKEN_DEL_CALLBACK' \
  --data-urlencode 'product_types=accounts,portfolios'

Tabhair aird ar an Cóid Earráide: Ní dhéantar focal faire neamhbhailí a thriail; tá cothabháil eintiteas.

Sonraíocht OpenAPI v3
Bailiúchán Postman

Mura bhfuil an token bailí a thuilleadh (athrú pasfhocal nó 2FA nua), oscail an ghiuirléid arís tríd an luach sin a chur ar wr_conf.token chun an t-úsáideoir a athfhíordheimhniú.

Nuashonraithe 2026-09-10