Kryptomaksujen yhdyskäytävän rajapinta: laskut, webhookit, tilitykset ja white label

Mitä kryptomaksujen yhdyskäytävän rajapinta tekee?

Rajapinta piilottaa lohkoketjun koodiltasi. Solmujen ylläpidon, osoitteiden johtamisen ja vahvistusten laskemisen sijaan kutsut päätepistettä laskun luomiseksi, tallennat yhdyskäytävän tunnisteen ja odotat ilmoituksia. Yhdyskäytävä ilmoittaa vaihtokurssin, seuraa verkkoja, soveltaa AML-seulontaa ja tilittää saldollesi.

Useimmat yhdyskäytävät tarjoavat samat rakennuspalikat eri nimillä: laskut tai tilaukset saapuville maksuille, IPN tai callbackit ilmoituksille, vaihto- ja saldopäätepisteet sekä tilitykset tai nostot lähteville siirroille. Hiekkalaatikot ovat useimmilla palveluntarjoajilla, esimerkiksi erillinen hiekkalaatikkopalvelin CoinGatella ja hiekkalaatikkotili NOWPaymentsilla, ja niitä tulee käyttää ennen mitään mainnet-testiä.

• Lasku-rajapinta: maksupyyntöjen luonti, luku ja peruutus fiat-hinnalla, hyväksytyillä kolikoilla, tilausviitteellä ja callback-osoitteella
• Ilmoitukset: webhookit tai IPN jokaisesta tilamuutoksesta, yleensä allekirjoitettuina
• Tilitys-rajapinta: krypton tai fiatin lähetys asiakkaille, kumppaneille tai omaan lompakkoosi
• Kurssit ja valuutat: tuettujen kolikoiden, verkkojen ja vähimmäismäärien luettelo sekä reaaliaikaiset hinnat
• Lisäosat ja SDK:t: valmiit moduulit verkkokauppa-alustoille saman rajapinnan päällä

Miten laskun elinkaari toimii?

Jokaisella yhdyskäytävällä on oma tilamallinsa, joten yhdistä ne pieneen sisäiseen joukkoon ennen liiketoimintalogiikan kirjoittamista. Vain lopullinen maksettu-tila saa vapauttaa tuotteet; väliaikaiset tilat ovat olemassa, koska tapahtuma voi näkyä lohkoketjussa pitkään ennen kuin sen hyväksyminen on turvallista.

Taulukko yhdistää kaksi julkaistua tilamallia useimpien alustojen tarvitsemiin tiloihin. CoinGate esimerkiksi vanhentaa maksamattoman laskun 20 minuutin kuluttua siitä, kun ostaja on valinnut kolikon, ja merkitsee AML-tarkistuksessa liputetut maksut tilaan invalid.

Miten kryptowebhookit ja IPN tulisi varmentaa?

Pidä jokaista ilmoitusta epäluotettavana, kunnes se on varmennettu. Yhdyskäytävät käyttävät eri menetelmiä: NOWPayments allekirjoittaa lajitellun JSON-rungon HMAC-SHA512:lla ja lähettää allekirjoituksen otsakkeessa x-nowpayments-sig, CoinGate lähettää tilauksessa asettamasi tokenin, ja BitPay suosittelee noutamaan laskun rajapinnasta jokaisen ilmoituksen jälkeen sen sijaan, että luotettaisiin ilmoituksen sisältöön.

Turvallisin tapa yhdistää molemmat: varmenna allekirjoitus, lue sitten lasku rajapinnasta ja toimi sen vastauksen perusteella. Se maksaa yhden pyynnön tilamuutosta kohden ja suojaa väärennetyiltä tai uudelleentoistetuilta callbackeilta.

• Varmenna allekirjoitukset vakioaikaisella vertailulla ja hylkää allekirjoittamattomat pyynnöt
• Hae lasku uudelleen yhdyskäytävän tunnisteella ennen tilauksen tilan muuttamista
• Palauta HTTP 200 nopeasti ja käsittele asynkronisesti; yhdyskäytävät yrittävät uudelleen virheiden jälkeen
• Tallenna jokainen ilmoitus tapahtumineen tai tiloineen, jotta kaksoiskappaleet ohitetaan
• Älä koskaan luota selaimen uudelleenohjauksessa lähetettyihin summiin tai valuuttoihin

Miten alimaksut, ylimaksut ja myöhästyneet maksut hoidetaan?

Lompakot ja pörssit vähentävät nostokuluja, ja asiakkaat kopioivat summia puutteellisesti, joten tarkkaa maksua ei voi olettaa. Määritä toleranssi ja sääntö jokaiselle tapaukselle ennen käyttöönottoa ja tee lopputulos näkyväksi tukihenkilöstölle.

Miten idempotenssi ja täsmäytys toimivat?

Luo laskut omalla tilausviitteelläsi ja tee kutsusta turvallinen toistaa: jos pyyntö aikakatkeaa, hae lasku viitteellä ennen uuden luomista tai käytä idempotenssiavainta, jos yhdyskäytävä tukee sitä. Sama sääntö koskee tilityksiä, joissa kaksoispyyntö lähettää oikeaa rahaa kahdesti.

Täsmäytystä varten tallenna yhdyskäytävän laskun tunniste, tapahtuman tiiviste, fiat-summa, kryptosumma, kurssi ja kulu. Tilitysraportit listaavat tilitykset erinä, joten täsmäytys etenee tilauksesta laskuun ja tilitykseen eikä tilauksesta pankkitilin riville.

Mitä tilitys-rajapinta vaatii Travel Rulen mukaan?

Tilityspäätepisteet lähettävät kryptoa yhdyskäytäväsi saldolta osoitteeseen, usein erinä kumppanipalkkioille, markkinapaikan myyjille tai asiakkaiden nostoille. Useimmat vaativat osoitteiden hyväksymislistan, kaksivaiheisen hyväksynnän tai erilliset tilitysoikeudet sisältävän API-avaimen.

EU:ssa asetus (EU) 2023/1113 velvoittaa yhdyskäytävän välittämään lähettäjän ja saajan tiedot jokaisen siirron mukana sekä varmistamaan omassa hallussa olevien lompakoiden omistuksen yli 1 000 EUR:n siirroissa. Varaudu siihen, että tilityspyynnöt sisältävät saajan nimen ja osoitetyypin, ja suunnittele siirrot, jotka odottavat näitä tietoja.

Mitä white label -vaihtoehtoja kryptomaksuyhdyskäytävissä on?

Alustat, jotka jälleenmyyvät maksuja omille kauppiailleen, haluavat usein maksusivun oman brändinsä alle. Tasoja on kolme, ja hinta nousee hallinnan mukana. Plisio esimerkiksi ilmoittaa 0,5 % rajapinnalleen ja 1,5 % white label -palvelulle, ja NOWPayments myy erillistä white label -tuotetta.

Täysi white label siirtää vastuuta eikä vain brändiä. Jos otat kauppiaita käyttöön ja pidät heidän saldojaan hallussasi, tarvitset ehkä oman MiCA-luvan; luvan saaneen yhdyskäytävän alikauppiasmallin käyttö pitää velvoitteen yhdyskäytävällä.

Kryptoyhdyskäytävien rajapintojen yhdistäminen OrsunPayn kautta

OrsunPay yhdenmukaistaa kryptoyhdyskäytävien tilat, webhookit ja hyvitykset yhdeksi rajapinnaksi korttien ja pankkien palveluntarjoajiesi rinnalle käyttäen omia yhdyskäytävätilejäsi. OrsunPay ei säilytä kryptoa eikä aja tilityksiä omalta saldoltaan; se reitittää pyynnöt valitsemallesi yhdyskäytävälle ja palauttaa allekirjoitetut, kaksoiskappaleista puhdistetut tapahtumat.

Kryptovaluuttojen maksuyhdyskäytävän rajapinnan integrointi

1. Avaa hiekkalaatikkotilit Luo yhdyskäytävään hiekkalaatikko- ja tuotantotilit, luo erilliset API-avaimet laskuille ja tilityksille ja aseta IPN-salaisuus.
2. Yhdistä tilat Käännä yhdyskäytävän tilat sisäisiksi tiloiksesi ja päätä, mikä niistä vapauttaa tuotteet.
3. Luo laskut idempotentisti Lähetä fiat-summa, valuutta, tilausviite ja callback-osoite; hae viitteellä ennen kuin yrität uudelleen aikakatkennutta kutsua.
4. Varmenna ilmoitukset Tarkista allekirjoitus, hae lasku uudelleen rajapinnasta ja käsittele tapahtuma kerran.
5. Käsittele poikkeustapaukset Toteuta toleranssin, täydennyksen, hyvityksen ja vanhenemisen käsittelyt ja testaa jokainen hiekkalaatikossa.
6. Täsmäytä tilitykset Tallenna tapahtuman tiiviste, kurssi ja kulu laskukohtaisesti ja yhdistä tilityserät tilauksiin päivittäin.