Krüptomakselüüsi API: arved, webhookid, väljamaksed ja white label

Mida krüptomakselüüsi API teeb?

API peidab plokiahela Teie koodi eest. Selle asemel et hallata sõlmi, tuletada aadresse ja lugeda kinnitusi, kutsute lõpp-punkti arve loomiseks, salvestate lüüsi tunnuse ja ootate teavitusi. Lüüs pakub vahetuskursi, jälgib võrke, rakendab rahapesu skriinimist ja arveldab Teie saldole.

Enamik lüüse pakub samu ehitusplokke erinevate nimede all: arved või tellimused sissetulevate maksete jaoks, IPN või tagasikutsed teavituste jaoks, konverteerimise ja saldo lõpp-punktid ning väljamaksed või väljavõtted väljaminevate ülekannete jaoks. Liivakastid on olemas enamikul pakkujatel, näiteks eraldi liivakasti host CoinGate'is ja liivakastikonto NOWPaymentsis, ning neid tuleks kasutada enne igat mainneti testi.

• Arve API: maksenõuete loomine, lugemine ja tühistamine fiathinna, aktsepteeritud müntide, tellimuse viite ja tagasikutse URL-iga
• Teavitused: webhookid või IPN igal staatuse muutusel, tavaliselt allkirjastatud
• Väljamaksete API: krüpto või fiatraha saatmine klientidele, partneritele või oma rahakotti
• Kursid ja valuutad: toetatud müntide, võrkude, miinimumsummade ja reaalajas hinnapakkumiste loend
• Pistikprogrammid ja SDK-d: valmismoodulid e-kaubanduse platvormidele sama API peal

Kuidas arve elutsükkel toimib?

Igal lüüsil on oma staatusemudel, seega vastendage need enne äriloogika kirjutamist väikese sisemise hulgaga. Kaupa tohib vabastada ainult lõplik makstud staatus; vahestaatused on olemas, sest tehingut võib plokiahelas näha kaua enne, kui seda on ohutu vastu võtta.

Tabel vastendab kaks avaldatud staatusemudelit olekutega, mida enamik platvorme vajab. CoinGate aegutab näiteks tasumata arve 20 minutit pärast seda, kui ostja on mündi valinud, ning märgib rahapesukontrolli poolt lipuga tähistatud maksed kehtetuks.

Kuidas krüptomaksete webhooke ja IPN-i kontrollida?

Käsitlege iga teavitust usaldamatuna, kuni see on kontrollitud. Lüüsid kasutavad erinevaid skeeme: NOWPayments allkirjastab sorteeritud JSON-keha HMAC-SHA512-ga ja saadab selle päises x-nowpayments-sig, CoinGate saadab tellimusele määratud tokeni ning BitPay soovitab pärast iga teavitust arve API-st uuesti tuua, selle asemel et usaldada teavituse keha.

Kõige turvalisem muster ühendab mõlemad: kontrollige allkirja ja lugege seejärel arve API-st ning tegutsege selle vastuse põhjal. See maksab ühe päringu staatuse muutuse kohta ja kaitseb võltsitud või kordusena saadetud tagasikutsete eest.

• Kontrollige allkirju konstantse ajaga võrdlusega ja lükake allkirjastamata päringud tagasi
• Tooge arve lüüsi tunnuse alusel uuesti enne tellimuse oleku muutmist
• Tagastage HTTP 200 kiiresti ja töötlege asünkroonselt; lüüsid kordavad vigade korral
• Salvestage iga teavitus koos sündmuse või staatusega, et duplikaadid ignoreerida
• Ärge kunagi usaldage brauseri ümbersuunamises saadetud summasid ega valuutasid

Kuidas käsitleda alamakseid, ülemakseid ja hilinenud makseid?

Rahakotid ja börsid arvavad maha väljamakse tasud ning kliendid kopeerivad summasid ebatäpselt, seega ei saa täpset makset eeldada. Määratlege enne käivitamist tolerants ja reegel igaks juhtumiks ning tehke tulemus nähtavaks tugitöötajatele.

Kuidas idempotentsus ja sobitamine toimivad?

Looge arved oma tellimuse viitega ja muutke kutse korduskindlaks: kui päring aegub, otsige arve viite järgi üles, enne kui loote uue, või kasutage idempotentsusvõtit, kui lüüs seda toetab. Sama reegel kehtib väljamaksete kohta, kus topeltpäring saadab päris raha kaks korda.

Sobitamiseks salvestage lüüsi arve tunnus, tehingu räsi, fiatsumma, krüptosumma, kurss ja tasu. Arveldusaruanded loetlevad väljamaksed partiidena, seega kulgeb sobitamine tellimusest arveni ja sealt väljamakseni, mitte tellimusest pangaväljavõtte reani.

Mida väljamaksete API vajab Travel Rule'i kohaselt?

Väljamaksete lõpp-punktid saadavad krüptot Teie lüüsi saldolt aadressile, sageli partiidena sidusettevõtete komisjonitasude, turuplatsi müüjate või klientide väljavõtete jaoks. Enamik nõuab aadresside lubatud nimekirja, kahefaktorilist kinnitust või API võtit eraldi väljamaksete õigustega.

ELis nõuab määrus (EL) 2023/1113, et lüüs edastaks iga ülekandega saatja ja saaja teabe ning kontrolliks isehallatavate rahakottide omandiõigust üle 1 000 € ülekannete puhul. Oodake, et väljamaksenõuded sisaldavad saaja nime ja aadressi tüüpi, ning planeerige ülekanded, mis ootavad neid andmeid.

Millised on white label krüptomakselüüsi võimalused?

Platvormid, mis müüvad makseid edasi oma kaupmeestele, soovivad sageli makseleht oma brändi all. Tasemeid on kolm ja hind tõuseb koos kontrolliga. Plisio loetleb näiteks 0,5% oma API ja 1,5% white label'i eest ning NOWPayments müüb eraldi white label toodet.

Täielik white label nihutab vastutust lisaks brändingule. Kui võtate kaupmehi pardale ja hoiate nende saldosid, võib Teil olla vaja oma MiCA volitust; volitatud lüüsi alamkaupmehe mudeli kasutamine hoiab selle kohustuse lüüsi juures.

Kuidas ühendada krüptolüüside API-d OrsunPay kaudu

OrsunPay ühtlustab krüptolüüside staatused, webhookid ja tagasimaksed üheks API-ks koos Teie kaardi- ja pangapakkujatega, kasutades Teie enda lüüsikontosid. See ei hoia krüptot ega tee väljamakseid oma saldolt; see marsruutib päringud Teie valitud lüüsile ja annab tagasi allkirjastatud, duplikaadivabad sündmused.

Kuidas integreerida krüptovaluuta makselüüsi API-t

1. Avage liivakastikontod Looge lüüsis liivakasti- ja toodangukontod, genereerige eraldi API võtmed arvete ja väljamaksete jaoks ning määrake IPN-i saladus.
2. Vastendage staatused Tõlkige lüüsi staatused oma sisemisteks olekuteks ja otsustage, milline neist vabastab kauba.
3. Looge arved idempotentselt Saatke fiatsumma, valuuta, tellimuse viide ja tagasikutse URL; otsige aegunud kutse korral enne kordamist viite järgi.
4. Kontrollige teavitusi Kontrollige allkirja, tooge arve API-st uuesti ja töödelge sündmust ühe korra.
5. Käsitlege erijuhte Realiseerige tolerants, juurdemaksmine, tagasimakse ja aegumise vood ning testige igaühte liivakastis.
6. Sobitage arveldused Salvestage arve kohta tehingu räsi, kurss ja tasu ning sobitage väljamaksepartiid tellimustega iga päev.