Kriptovaliutų mokėjimo šliuzo API: sąskaitos, webhook, išmokos ir white label

Ką daro kriptovaliutų mokėjimo šliuzo API?

API paslepia blokų grandinę nuo Jūsų kodo. Užuot valdę mazgus, išvedę adresus ir skaičiavę patvirtinimus, iškviečiate galinį tašką sąskaitai sukurti, išsaugote šliuzo identifikatorių ir laukiate pranešimų. Šliuzas pateikia valiutos kursą, stebi tinklus, taiko pinigų plovimo prevencijos patikrą ir atsiskaito į Jūsų balansą.

Dauguma šliuzų siūlo tuos pačius statybinius blokus skirtingais pavadinimais: sąskaitas ar užsakymus gaunamiems mokėjimams, IPN ar atgalinius iškvietimus pranešimams, konvertavimo ir balanso galinius taškus bei išmokas ar išėmimus išeinantiems pervedimams. Smėlio dėžės yra daugumos teikėjų, pavyzdžiui, atskiras smėlio dėžės serveris CoinGate ir smėlio dėžės paskyra NOWPayments, ir jas reikia naudoti prieš bet kokį mainnet testą.

• Sąskaitų API: mokėjimo prašymų kūrimas, skaitymas ir atšaukimas su fiat kaina, priimamomis monetomis, užsakymo nuoroda ir atgalinio iškvietimo URL
• Pranešimai: webhook ar IPN kiekvieno statuso pasikeitimo metu, paprastai pasirašyti
• Išmokų API: kriptovaliutos ar fiat siuntimas klientams, partneriams ar į savo piniginę
• Kursai ir valiutos: palaikomų monetų, tinklų, minimalių sumų ir realaus laiko kainų sąrašas
• Papildiniai ir SDK: paruošti moduliai el. prekybos platformoms ant to paties API

Kaip veikia sąskaitos gyvavimo ciklas?

Kiekvienas šliuzas turi savo statusų modelį, todėl prieš rašydami verslo logiką juos susiekite su nedideliu vidiniu rinkiniu. Prekes atleisti turi tik galutinis apmokėtas statusas; tarpiniai statusai egzistuoja, nes operaciją blokų grandinėje galima pamatyti gerokai anksčiau, nei ją saugu priimti.

Lentelėje du paskelbti statusų modeliai susieti su būsenomis, kurių reikia daugumai platformų. Pavyzdžiui, CoinGate neapmokėtos sąskaitos galiojimas baigiasi po 20 minučių, kai pirkėjas pasirenka monetą, o pinigų plovimo prevencijos patikros pažymėtus mokėjimus pažymi kaip negaliojančius.

Kaip tikrinti kriptovaliutų webhook ir IPN?

Kiekvieną pranešimą laikykite nepatikimu, kol jis patikrintas. Šliuzai naudoja skirtingas schemas: NOWPayments pasirašo surūšiuotą JSON turinį HMAC-SHA512 ir siunčia jį antraštėje x-nowpayments-sig, CoinGate siunčia užsakymui nustatytą žetoną, o BitPay rekomenduoja po kiekvieno pranešimo sąskaitą vėl gauti iš API, užuot pasitikėjus jo turiniu.

Saugiausias modelis jungia abu: patikrinkite parašą, tada perskaitykite sąskaitą iš API ir veikite pagal šį atsakymą. Tai kainuoja vieną užklausą per statuso pasikeitimą ir apsaugo nuo suklastotų ar pakartotų atgalinių iškvietimų.

• Tikrinkite parašus pastovaus laiko palyginimu ir atmeskite nepasirašytas užklausas
• Prieš keisdami užsakymo būseną sąskaitą iš naujo gaukite pagal šliuzo ID
• Greitai grąžinkite HTTP 200 ir apdorokite asinchroniškai; šliuzai kartoja klaidų atveju
• Saugokite kiekvieną pranešimą su įvykiu ar statusu, kad dublikatai būtų ignoruojami
• Niekada nepasitikėkite sumomis ar valiutomis, atsiųstomis naršyklės nukreipime

Kaip tvarkyti nepakankamus mokėjimus, permokėjimus ir pavėluotus mokėjimus?

Piniginės ir biržos išskaičiuoja išėmimo mokesčius, o klientai sumas nukopijuoja netiksliai, todėl tikslaus mokėjimo tikėtis negalima. Prieš paleidimą apibrėžkite leistiną nuokrypį ir taisyklę kiekvienam atvejui bei rezultatą parodykite pagalbos darbuotojams.

Kaip veikia idempotentiškumas ir suderinimas?

Kurkite sąskaitas su savo užsakymo nuoroda ir padarykite iškvietimą saugų kartoti: jei užklausa baigiasi laiko limitu, prieš kurdami naują sąskaitą suraskite ją pagal nuorodą arba naudokite idempotentiškumo raktą, jei šliuzas jį palaiko. Ta pati taisyklė galioja išmokoms, kur pasikartojusi užklausa du kartus išsiunčia tikrus pinigus.

Suderinimui išsaugokite šliuzo sąskaitos ID, operacijos maišą, fiat sumą, kriptovaliutos sumą, kursą ir mokestį. Atsiskaitymo ataskaitos išmokas išvardija paketais, todėl suderinimas vyksta nuo užsakymo prie sąskaitos ir išmokos, o ne nuo užsakymo prie banko išrašo eilutės.

Ko išmokų API reikia pagal Travel Rule?

Išmokų galiniai taškai siunčia kriptovaliutą iš Jūsų šliuzo balanso į adresą, dažnai paketais, pavyzdžiui, partnerių komisiniams, prekyvietės pardavėjams ar klientų išėmimams. Dauguma reikalauja adresų baltojo sąrašo, dviejų veiksnių patvirtinimo arba API rakto su atskiromis išmokų teisėmis.

Reglamentas (ES) 2023/1113 reikalauja, kad šliuzas su kiekvienu pervedimu perduotų siuntėjo ir gavėjo informaciją bei pervedimams virš 1 000 € patikrintų savarankiškai valdomų piniginių nuosavybę. Tikėkitės, kad išmokų užklausose bus gavėjo vardas ir adreso tipas, ir planuokite pervedimus, kurie laukia šių duomenų.

Kokios yra white label kriptovaliutų mokėjimo šliuzo galimybės?

Platformos, parduodančios mokėjimus savo prekybininkams, dažnai nori mokėjimo puslapio su savo prekės ženklu. Yra trys lygiai, o kaina auga didėjant kontrolei. Pavyzdžiui, Plisio nurodo 0,5 % už savo API ir 1,5 % už white label, o NOWPayments parduoda atskirą white label produktą.

Visiškas white label perkelia ne tik prekės ženklą, bet ir atsakomybę. Jei registruojate prekybininkus ir laikote jų balansus, Jums gali prireikti savo MiCA įgaliojimo; naudojant įgalioto šliuzo sub-prekybininko modelį ši pareiga lieka šliuzui.

Kaip prijungti kriptovaliutų šliuzų API per OrsunPay

OrsunPay suvienodina kriptovaliutų šliuzų statusus, webhook ir grąžinimus į vieną API kartu su Jūsų kortelių ir banko teikėjais, naudodamas Jūsų pačių šliuzų paskyras. Jis nelaiko kriptovaliutos ir nevykdo išmokų iš savo balanso; jis nukreipia užklausas Jūsų pasirinktam šliuzui ir grąžina pasirašytus, dublikatų neturinčius įvykius.

Kaip integruoti kriptovaliutų mokėjimo šliuzo API

1. Atidarykite smėlio dėžės paskyras Sukurkite smėlio dėžės ir gamybos paskyras šliuze, sugeneruokite atskirus API raktus sąskaitoms ir išmokoms ir nustatykite IPN paslaptį.
2. Susiekite statusus Išverskite šliuzo statusus į savo vidines būsenas ir nuspręskite, kuri iš jų atleidžia prekes.
3. Kurkite sąskaitas idempotentiškai Siųskite fiat sumą, valiutą, užsakymo nuorodą ir atgalinio iškvietimo URL; po laiko limitą viršijusio iškvietimo prieš kartodami suraskite sąskaitą pagal nuorodą.
4. Tikrinkite pranešimus Patikrinkite parašą, iš naujo gaukite sąskaitą iš API ir apdorokite įvykį vieną kartą.
5. Tvarkykite ypatingus atvejus Įgyvendinkite nuokrypio, papildymo, grąžinimo ir galiojimo pabaigos eigas ir išbandykite kiekvieną smėlio dėžėje.
6. Suderinkite atsiskaitymus Kiekvienai sąskaitai išsaugokite operacijos maišą, kursą ir mokestį ir kasdien suderinkite išmokų paketus su užsakymais.