Íocaíochtaí Fast Track

Osclaíonn an t-íocóir an URL sin agus údaraíonn sé an íocaíocht ina bhanc. Faoin dromchla cruthaítear an intinn íocaíochta dho-athraithe chéanna agus a chruthaíonn an chuid eile den API: socraítear an méid, an tairbhí agus an tagairt sula sroicheann siad an brabhsálaí, agus cuireann an ceanntásc Idempotency-Key cosc ar dhara muirear má bhristear an glao.

Cruthaigh an íocaíocht

POST /payments/?action=fast-track

Ceanntásca éigeantacha: Content-Type: application/json, X-API-Key agus Idempotency-Key. Bíonn idir 16 agus 128 carachtar san eochair, tosaíonn sí le litir nó uimhir agus ní cheadaíonn sí ach litreacha, uimhreacha agus . _ : -; is leor UUID v4. Má tá sí ar iarraidh nó mura bhfuil a fad bailí, is é 400 idempotency_key_required an freagra; má úsáideann sí carachtair eile, 422 invalid_customer_reference. Is í an eochair sin tagairt an cheannaí freisin: ní gá í a sheoladh sa chorp. Má sheolann tú an eochair chéanna arís leis an gcorp céanna, faigheann tú an URL céanna arís. Má athúsáideann tú í le sonraí eile, is é 409 idempotency_conflict an freagra.

Tá gach réimse éigeantach seachas logo. Is liosta ceadaithe é an corp. Freagraíonn réimse breise, nó réimse éigeantach atá ar iarraidh, le 422 invalid_request. Is cuid den íocaíocht é logo: má athúsáidtear an Idempotency-Key céanna le logo eile, is 409 idempotency_conflict é freisin.

Níl teorainn dá cuid féin ag íocaíocht láithreach san API seo. Diúltaíonn an banc don íocaíocht nach féidir leis glacadh léi, mar gheall ar an méid freisin, agus tagann an diúltú sin mar KO chuig an notification_url.

: "${WR_API_KEY:?Defina WR_API_KEY en el entorno seguro de su backend}"
: "${WR_PAYMENT_IDEMPOTENCY_KEY:?Genere un UUID v4 para este pago}"

curl --request POST 'https://api.wealthreader.com/payments/?action=fast-track' \
  --header 'Content-Type: application/json' \
  --header "X-API-Key: ${WR_API_KEY}" \
  --header "Idempotency-Key: ${WR_PAYMENT_IDEMPOTENCY_KEY}" \
  --data '{
    "amount": "15.50",
    "currency": "EUR",
    "beneficiary": {
      "name": "Comercio Online S.L.",
      "iban": "ES9121000418450200051332"
    },
    "reference": "Pedido 78901",
    "priority": "normal",
    "notification_url": "https://tienda.example.com/pagos/aviso",
    "logo": "https://tienda.example.com/marca/logo.svg"
  }'

Tá an URL agus aitheantóir na híocaíochta sa fhreagra, le 201 an chéad uair agus 200 má bhí an eochair ann cheana:

{
  "url": "https://widget.wealthreader.com/payments/pay/#payment_intent_id=…&widget_token=…&api_origin=https%3A%2F%2Fapi.wealthreader.com",
  "payment_intent_id": "22222222-2222-4222-8222-222222222222"
}

Atreoraigh an t-íocóir chuig an URL. Tá an token i mblúire an URL, téann sé in éag leis an ngiuirléid (15 nóiméad de ghnáth) agus níor cheart é a chlárú i do logaí. Sábháil payment_intent_id in éineacht le d'ordú.

Fógra OK nó KO

Nuair a sheiceálann Wealthreader stádas na híocaíochta agus nuair a aimsíonn sé i staid dheiridh í, déanann sé POST chuig notification_url le Content-Type: application/json agus User-Agent: WealthReader-Payments:

{
  "outcome": "ok",
  "payment_status": "settled",
  "customer_reference": "11111111-1111-4111-8111-111111111111",
  "payment_intent_id": "22222222-2222-4222-8222-222222222222"
}

• Ní bhíonn outcome ina ok ach amháin má tá an íocaíocht socraithe ag an mbanc (settled). Tugann rejected, cancelled, expired agus failed fógra ko. Ní toradh deiridh é toradh débhríoch (reconciliation_required) agus ní thugtar fógra faoi.
• Is é customer_reference do Idempotency-Key agus is é payment_intent_id an t-aitheantóir a tugadh ar ais nuair a cruthaíodh an íocaíocht.
• Freagair le 2xx chun an fógra a mheas mar sheachadta. Fanann Wealthreader 3 soicind ar a mhéad agus ní leanann sé atreoruithe.
• D'fhéadfadh an fógra céanna teacht níos mó ná uair amháin: láimhseáil customer_reference móide outcome mar idempotent.
• Diúltaítear do URL nach https poiblí é nuair a chruthaítear an íocaíocht, agus seiceáiltear arís é roimh gach seoladh.

Cathain a thagann sé. Seiceáiltear an stádas fad atá an t-íocóir fós ar an leathanach íocaíochta, a fhiosraíonn é go dtí an toradh deiridh nó go dtí go dtéann an seisiún íocaíochta in éag, agus gach uair a ghlaonn tú ar POST /payments/?action=status. Níl aon seoladh sceidealaithe ar leith ann: má dhúnann an t-íocóir an leathanach sula gcríochnaíonn an banc, nó mura bhfreagraíonn do fhreastalaí le 2xx, seoltar an fógra ag an gcéad seiceáil eile. Dá bhrí sin, mura bhfuair tú an fógra cúpla nóiméad tar éis duit an t-íocóir a atreorú, seiceáil an stádas leis an payment_intent_id; spreagann an fiosrú sin an fógra atá ar feitheamh freisin. Féach Stádas, comhairliúchán tréimhsiúil stádais agus athmhuintearas.

Níl an fógra sínithe. Sula seachadann tú earra nó seirbhís luachmhar, deimhnigh an toradh le POST /payments/?action=status ag úsáid do X-API-Key agus an payment_intent_id: is é payment_status: settled sa fhreagra sin an t-aon dearbhú airgeadais.