maksete API liidestamine

API liidestamise juhend

Kavandage maksete API autentimine, tehinguviited, olekupäringud ja teavituste turvalisus. Kontrollige enne rakendamist kehtivat tehnilist spetsifikatsiooni.

Esiletõstetud

Teie vajadusele sobiv lähenemine

Hinnake koos töövoogu, tehnilist ulatust ja haldusvajadusi.

01

Spetsifikatsioon

Kontrollige väljade ja olekute tähendust kehtivast tehnilisest dokumendist.

02

Teavitus

Testige kontrollimist ja korduvate sündmuste käitumist.

03

Kinnitus

Eristage tehniline vastus finantstulemusest.

Makse-API päringu õnnestumine HTTP tasandil ei näita alati finantstehingu lõpuleviimist. Teie rakendus peab hindama tehnilist vastust, makseolekut ja tellimustulemust eraldi. See leht on näitlik kavandamise kontrollnimekiri ega paku kontrollimata lõpp-punkte või toimivat ligipääsuvõtit.

Täpsustage päringumudel

Summa ühik, valuuta täpsus ja ärilise tehinguviite unikaalsus tuleb lugeda kehtivast API spetsifikatsioonist. Tootmispäringut ei tohi saata oletatava summavormingu ega väljanimega.

  • Kinnitage autentimisviis ja võtmete uuendamise protsess.
  • Kontrollige idempotentsuse ulatust nii kliendi kui teenusepakkuja puhul.
  • Määrake ajalõpu ja korduskatsete reeglid eraldi.

Töödelge teavitusi turvaliselt

Veebihaagi allkiri või kontrollimeetod tuleb rakendada kehtiva spetsifikatsiooni järgi. Testida tuleb sama sündmuse korduvat saabumist ja sündmuste järjekorra muutumist. Teavituse vastuvõtmine ning ärikirje töötlemine peavad olema eraldi jälgitavad.

Tulemus ja finantsiline kinnitus

Ebaselgete tehingute lõplikku tulemust uuritakse olekupäringuga. Ka tühistamise ja tagasimakse vastused seotakse sama äriviitega. Tootmisühenduse andmeid tuleb jagada turvalise kanali kaudu pärast tehnilise ulatuse täpsustamist.

Seotud lahendused ja materjalid

KKK

Korduma kippuvad küsimused

Lühivastused, mida ulatuse hindamisel vaja võib minna.

Kas lehel on käivitatav lõpp-punkt? +

Ei. Lõpp-punkti näidet ei avaldata enne keskkonna kehtiva aadressi ja API spetsifikatsiooni kontrollimist.

Kas HTTP 200 tähendab edukat makset? +

Mitte alati. Eraldi tuleb hinnata vastuses olevat tehinguolekut ja vajalikku teenusepakkuja kinnitust.

Kas ajalõpu korral tuleks sama päring uuesti saata? +

Esmalt tuleb kontrollida olekut ja idempotentsuse käitumist. Kontrollimatu kordamine võib põhjustada topeltmakseid.