Kripto maksājumu vārtejas API: rēķini, webhook, izmaksas un white label

Ko dara kripto maksājumu vārtejas API?

API paslēpj blokķēdi no jūsu koda. Tā vietā, lai uzturētu mezglus, atvasinātu adreses un skaitītu apstiprinājumus, jūs izsaucat galapunktu rēķina izveidei, saglabājat vārtejas identifikatoru un gaidāt paziņojumus. Vārteja nosauc maiņas kursu, uzrauga tīklus, piemēro AML pārbaudes un veic norēķinus uz jūsu bilanci.

Lielākā daļa vārteju piedāvā vienus un tos pašus pamatelementus ar dažādiem nosaukumiem: rēķini vai pasūtījumi ienākošajiem maksājumiem, IPN vai callback paziņojumiem, konvertācijas un bilances galapunkti, kā arī izmaksas vai izņemšanas izejošiem pārvedumiem. Sandbox vide ir lielākajai daļai sniedzēju, piemēram, atsevišķs sandbox resursdators CoinGate un sandbox konts NOWPayments, un tā jāizmanto pirms jebkura mainnet testa.

• Rēķinu API: maksājuma pieprasījumu izveide, lasīšana un atcelšana ar fiat cenu, pieņemtajām monētām, pasūtījuma atsauci un callback URL
• Paziņojumi: webhook vai IPN katrā statusa maiņā, parasti parakstīti
• Izmaksu API: kriptovalūtas vai fiat sūtīšana klientiem, partneriem vai jūsu pašu makam
• Kursi un valūtas: atbalstīto monētu, tīklu, minimālo summu un aktuālo kotējumu saraksts
• Spraudņi un SDK: gatavi moduļi e-komercijas platformām uz tā paša API

Kā darbojas rēķina dzīves cikls?

Katrai vārtejai ir savs statusu modelis, tāpēc pirms biznesa loģikas rakstīšanas pārveidojiet tos nelielā iekšējā kopā. Preces drīkst izdot tikai galīgs apmaksāts statuss; starpstatusi pastāv tāpēc, ka darījumu blokķēdē var redzēt ilgi pirms tā pieņemšana kļūst droša.

Tabulā divi publicētie statusu modeļi ir sasaistīti ar stāvokļiem, kas vajadzīgi lielākajai daļai platformu. CoinGate, piemēram, neapmaksātam rēķinam beidz derīgumu pēc 20 minūtēm, kad pircējs ir izvēlējies monētu, un maksājumus, ko atzīmējušas AML pārbaudes, atzīmē kā nederīgus.

Kā pārbaudīt kripto webhook un IPN?

Katru paziņojumu uzskatiet par neuzticamu, kamēr tas nav pārbaudīts. Vārtejas izmanto dažādas shēmas: NOWPayments paraksta sakārtoto JSON saturu ar HMAC-SHA512 un nosūta to galvenē x-nowpayments-sig, CoinGate sūta jūsu pasūtījumam iestatītu token, bet BitPay iesaka pēc katra paziņojuma izgūt rēķinu no API, nevis uzticēties paziņojuma saturam.

Drošākais risinājums apvieno abus: pārbaudiet parakstu, tad nolasiet rēķinu no API un rīkojieties pēc šīs atbildes. Tas izmaksā vienu pieprasījumu uz katru statusa maiņu un pasargā no viltotiem vai atkārtotiem callback.

• Pārbaudiet parakstus ar salīdzināšanu konstantā laikā un noraidiet neparakstītus pieprasījumus
• Pirms pasūtījuma stāvokļa maiņas atkārtoti izgūstiet rēķinu pēc vārtejas ID
• Ātri atgrieziet HTTP 200 un apstrādājiet asinhroni; kļūdu gadījumā vārtejas mēģina atkārtoti
• Saglabājiet katru paziņojumu kopā ar tā notikumu vai statusu, lai dublikāti tiktu ignorēti
• Nekad neuzticieties summām vai valūtām, kas atnāk pārlūka novirzīšanā

Kā rīkoties ar nepietiekamu apmaksu, pārmaksu un nokavētiem maksājumiem?

Maki un biržas ieturē izņemšanas maksas, un klienti summas pārkopē neprecīzi, tāpēc precīzu apmaksu pieņemt nedrīkst. Pirms palaišanas nosakiet pieļaujamo novirzi un noteikumu katram gadījumam un padariet rezultātu redzamu atbalsta darbiniekiem.

Kā darbojas idempotence un saskaņošana?

Veidojiet rēķinus ar savu pasūtījuma atsauci un padariet izsaukumu drošu atkārtošanai: ja pieprasījumam iestājas taimauts, pirms jauna rēķina izveides meklējiet esošo pēc atsauces vai izmantojiet idempotences atslēgu, ja vārteja to atbalsta. Tas pats attiecas uz izmaksām, kur dublēts pieprasījums divreiz nosūta reālu naudu.

Saskaņošanai saglabājiet vārtejas rēķina ID, darījuma hešu, fiat summu, kriptovalūtas summu, kursu un maksu. Norēķinu atskaitēs izmaksas ir uzskaitītas pa partijām, tāpēc saskaņošana notiek no pasūtījuma uz rēķinu un uz izmaksu, nevis no pasūtījuma uz bankas izraksta rindu.

Kas izmaksu API vajadzīgs saskaņā ar Travel Rule?

Izmaksu galapunkti sūta kriptovalūtu no jūsu vārtejas bilances uz adresi, bieži partijās, piemēram, partneru komisijām, tirgus vietas pārdevējiem vai klientu izņemšanām. Lielākā daļa prasa adrešu baltos sarakstus, divfaktoru apstiprinājumu vai API atslēgu ar atsevišķām izmaksu tiesībām.

ES Regula (ES) 2023/1113 prasa, lai vārteja ar katru pārvedumu nodotu informāciju par izcelsmes pusi un saņēmēju un pārbaudītu paša pārvaldītu maku piederību virs 1 000 EUR. Sagaidiet, ka izmaksu pieprasījumos būs jānorāda saņēmēja vārds un adreses veids, un plānojiet pārvedumus, kas gaida šos datus.

Kādas ir white label kripto maksājumu vārtejas iespējas?

Platformas, kas pārdod maksājumus saviem tirgotājiem, bieži vēlas maksājuma lapu ar savu zīmolu. Ir trīs līmeņi, un cena aug līdz ar kontroli. Plisio, piemēram, norāda 0,5 % par savu API un 1,5 % par white label, bet NOWPayments pārdod atsevišķu white label produktu.

Pilns white label pārnes ne tikai zīmolu, bet arī atbildību. Ja jūs piesaistāt tirgotājus un glabājat viņu bilances, jums var būt vajadzīga sava MiCA atļauja; izmantojot atļautas vārtejas sub-merchant modeli, šis pienākums paliek vārtejai.

Kā pieslēgt kripto vārteju API ar OrsunPay?

OrsunPay vienādo kripto vārteju statusus, webhook un atmaksas vienā API līdzās jūsu karšu un bankas sniedzējiem, izmantojot jūsu pašu vārteju kontus. Tas neglabā kriptovalūtu un nevada izmaksas no savas bilances; tas maršrutē pieprasījumus uz jūsu izvēlēto vārteju un atdod atpakaļ parakstītus, dublikātiem attīrītus notikumus.

Kā integrēt kriptovalūtu maksājumu vārtejas API

1. Atveriet sandbox kontus Izveidojiet sandbox un produkcijas kontus vārtejā, ģenerējiet atsevišķas API atslēgas rēķiniem un izmaksām un iestatiet IPN noslēpumu.
2. Sasaistiet statusus Pārveidojiet vārtejas statusus par saviem iekšējiem stāvokļiem un izlemiet, kurš no tiem izdod preces.
3. Veidojiet rēķinus idempotenti Nosūtiet fiat summu, valūtu, pasūtījuma atsauci un callback URL; pirms taimauta pieprasījuma atkārtošanas meklējiet pēc atsauces.
4. Pārbaudiet paziņojumus Pārbaudiet parakstu, atkārtoti izgūstiet rēķinu no API un apstrādājiet notikumu tikai vienreiz.
5. Apstrādājiet robežgadījumus Ieviesiet pieļaujamo novirzi, papildināšanas, atmaksas un termiņa beigu plūsmas un katru no tām pārbaudiet sandbox vidē.
6. Saskaņojiet norēķinus Katram rēķinam saglabājiet darījuma hešu, kursu un maksu un katru dienu saskaņojiet izmaksu partijas ar pasūtījumiem.