Stádas, comhairliúchán tréimhsiúil stádais agus athmhuintearas

Fiosraigh ón inneall

: "${WR_API_KEY:?Defina WR_API_KEY en el entorno seguro de su backend}"

curl --request POST 'https://api.wealthreader.com/payments/?action=status' \
  --header 'Content-Type: application/json' \
  --header "X-API-Key: ${WR_API_KEY}" \
  --data '{
    "payment_intent_id": "11111111-1111-4111-8111-111111111111",
    "refresh": true
  }'

refresh roghnach agus true de réir réamhshocraithe. Wealth Reader teorainn le fiosrúcháin sheachtracha de réir intinne; cuir backoff i bhfeidhm freisin ar do backend agus ná cruthaigh intinn eile chomh fada agus a bhíonn an toradh débhríoch.

Trí ghné éagsúla

Is é an t-aon dearbhú dearfach ná payment_status: settled, a dhíorthaítear ó stádas bainc sainráite a dheimhníonn socrú na híocaíochta. Ní hionann toradh teicniúil DONE, interaction_status: completed nó payment_status: pending ná socrú riamh.

Toradh débhríoch

Athraíonn titim líonra neamhaitheanta, teorainn ama nó freagra tar éis an tosaigh an intinn go reconciliation_required agus nochtann sé payment_status: unknown. Ní dhéantar an tús arís go huathoibríoch.

Ní thairgeann an soláthraí reatha fiosrúchán a atógann tionscnamh a raibh a fhreagra caillte: éilíonn a fhiosrúchán stáit an comhthéacs teimhneach a chuirtear ar ais ag an tionscnamh céanna. Dá bhrí sin, teastaíonn athmhuintearas láimhe ón gcás sin; ní féidir é a aisghabháil trí cheist thréimhsiúil ar an stát uathoibríoch nó trí chuardach a dhéanamh ar an ID callback.

Sa chás sin:

1. coinnigh an t-aitheantóir agus an eochair idempotency;
2. ní chruthaíonn sé intinn eile ná údarú arís;
3. Seiceáil stádas na híocaíochta trí iarratas fíordheimhnithe chuig Wealth Reader agus coinnigh do thagairt athmhuintearais shlán;
4. teagmháil a dhéanamh le tacaíocht theicniúil; ná lean ort ag seiceáil an stádais nuair a bhíonn automatic_recovery false.

Maidir le hintinn a dteastaíonn athmhuintearas láimhe uaidh, is féidir leis an gceist freastalaí-go-freastalaí na nithe seo a leanas a áireamh:

{
  "payment_status": "unknown",
  "reconciliation_required": true,
  "reconciliation": {
    "automatic_recovery": false,
    "reference": "wrp_recon_0123456789abcdef0123",
    "request_id": "11111111-1111-4111-8111-111111111111",
    "correlation_id": "22222222-2222-4222-8222-222222222222",
    "reason": "initiation_rejected"
  }
}

Is tagairtí iad na haitheantóirí sin a scríobhadh le haghaidh tacaíochta. Ní sheachadtar iad chuig an ngiuirléid agus ní ligeann siad don chustaiméir staid inmheánach an tsoláthraí a cheistiú nó a athchruthú.

reason cód Wealth Reader, riamh téacs an tsoláthróra. initiation_rejected le fios gur fhreagair an soláthróir le diúltú cinntitheach don tionscnamh; initiation_response_unavailable, nach raibh aon fhreagra aitheanta ann. Sa dá chás tá an tionscnamh tarchurtha cheana féin, mar sin ní dhéantar é arís: coinnigh an tagairt agus déan teagmháil le tacaíocht theicniúil.

Glaoch ar ais agus athsheinm

Sroicheann an tuairisceán SCA callback íocaíochta eisiach. Wealth Reader bailíochtaíonn sé an comhghaol, cuireann sé paraiméadair an bhainc ar aghaidh chuig an soláthraí mar atá siad (taifeadtar ainmneacha gan choinne, ní dhiúltaíonn siad tuairisceán údaraithe cheana féin), ídíonn sé an tuairisceán ach uair amháin, agus caomhnaíonn sé an stát íogair criptithe. Ní fhreagraíonn athrá ach HTTP 409; ní bhraitheann sé ar chód inmheánach sa chorp.

D'fhéadfadh go mbeadh atreoruithe iolracha ag teastáil chun fíordheimhniú. Leanann gach REDIRECT bailíochtaithe san fhuinneog SCA chéanna agus osclaíonn sé seicphointe callbacknua; ní chruthaíonn sé tionscnamh eile. Coinníonn DECOUPLED toradh an intinn i processing don ghiuirléid stádas a cheistiú. Ní dhéanann RETRY sainráite ach an críochnú a ullmhaíodh cheana féin, le fanacht agus líon teoranta iarrachtaí. ERROR, PASSWORD, MORE_INFO, SELECT_OPTION, críochnaíonn toradh anaithnid nó ídiú na dteorainneacha sin le hathmhuintearas, riamh i dtionscnamh nua.

Ní gá don cheannaí an callbacksin a fhoilsiú nó a phróiseáil. Ní sheolann an scaoileadh seo crúcaí gréasáin chuig an gceannaí: is é an conradh poiblí dearbhaithe an fiosrúchán tréimhsiúil ar an stát freastalaí-go-freastalaí.

An ghiuirléid á dhúnadh

flow_closed in iúl gur chríochnaigh an t-idirghníomhaíocht infheicthe. Is féidir leis an frontend an modal a dhúnadh, ach níor cheart dó "íoctha" a thaispeáint de bharr an imeachta sin. Tá an backend fós freagrach as an íocaíocht a dheimhniú nó a réiteach.

An chéad chéim eile

Comhlánaigh an liosta de Slándáil agus Tástáil.