Kripto fizetési átjáró API: számlák, webhookok, kifizetések és white label

Mit csinál a kripto fizetési átjáró API?

Az API elrejti a blokkláncot a kódja elől. Csomópontok üzemeltetése, címek származtatása és visszaigazolások számolása helyett meghív egy végpontot a számla létrehozásához, eltárolja az átjáró azonosítóját, és értesítésekre vár. Az átjáró megadja az árfolyamot, figyeli a hálózatokat, AML-szűrést alkalmaz, és az egyenlegére számol el.

A legtöbb átjáró ugyanazokat az építőelemeket kínálja különböző néven: számlák vagy rendelések a bejövő fizetésekhez, IPN vagy callback az értesítésekhez, váltási és egyenleg végpontok, valamint kifizetések vagy felvételek a kimenő átutalásokhoz. A legtöbb szolgáltatónál van sandbox, például a CoinGate-nél külön sandbox szerver, a NOWPaymentsnél sandbox fiók áll rendelkezésre, és ezt minden mainnet-teszt előtt használni kell.

• Számla API: fizetési kérelmek létrehozása, lekérdezése és törlése fiat árral, elfogadott érmékkel, rendelési hivatkozással és callback URL-lel
• Értesítések: webhookok vagy IPN minden státuszváltozáskor, általában aláírva
• Kifizetési API: kripto vagy fiat küldése ügyfeleknek, partnereknek vagy a saját tárcájába
• Árfolyamok és pénznemek: a támogatott érmék, hálózatok, minimális összegek és élő árfolyamok listája
• Bővítmények és SDK-k: kész modulok webshop-platformokhoz ugyanazon az API-n

Hogyan működik a számla életciklusa?

Minden átjárónak saját státuszmodellje van, ezért az üzleti logika megírása előtt képezze le őket egy kis belső készletre. Árut csak a végső fizetett státusz adhat ki; a köztes státuszok azért léteznek, mert egy tranzakció jóval azelőtt látható a blokkláncon, hogy biztonságosan elfogadható volna.

A táblázat két közzétett státuszmodellt rendel a legtöbb platformnak szükséges állapotokhoz. A CoinGate például a ki nem fizetett számlát 20 perc után lejáratja, miután a vásárló érmét választott, az AML-ellenőrzés által megjelölt fizetéseket pedig érvénytelennek jelöli.

Hogyan kell ellenőrizni a kripto webhookokat és az IPN-t?

Minden értesítést megbízhatatlannak kell tekinteni az ellenőrzésig. Az átjárók eltérő sémákat használnak: a NOWPayments a rendezett JSON-törzset HMAC-SHA512-vel írja alá, és az x-nowpayments-sig fejlécben küldi el; a CoinGate a rendeléshez beállított tokent küld; a BitPay pedig azt javasolja, hogy minden értesítés után kérdezze le a számlát az API-ból, ne bízzon a törzsében.

A legbiztonságosabb minta a kettőt ötvözi: ellenőrizze az aláírást, majd olvassa be a számlát az API-ból, és annak válasza alapján járjon el. Ez státuszváltozásonként egy kérésbe kerül, és megvédi a hamisított vagy újrajátszott callbackektől.

• Az aláírásokat állandó idejű összehasonlítással ellenőrizze, és utasítsa el az aláíratlan kéréseket
• A rendelés állapotának módosítása előtt kérdezze le újra a számlát az átjáró azonosítója alapján
• Gyorsan adjon vissza HTTP 200-at, és dolgozzon aszinkron módon; hiba esetén az átjárók újrapróbálkoznak
• Minden értesítést tároljon az eseményével vagy státuszával együtt, hogy a duplikátumokat figyelmen kívül lehessen hagyni
• Soha ne bízzon a böngészős átirányításban érkező összegekben vagy pénznemekben

Hogyan kezelendő az alulfizetés, a túlfizetés és a késői fizetés?

A tárcák és a tőzsdék felvételi díjat vonnak le, az ügyfelek pedig pontatlanul másolják az összegeket, így a pontos fizetés nem vehető biztosra. Indulás előtt határozzon meg egy toleranciát és szabályt minden esetre, és tegye láthatóvá az eredményt az ügyfélszolgálat számára.

Hogyan működik az idempotencia és az egyeztetés?

Hozza létre a számlákat saját rendelési hivatkozással, és tegye a hívást újrapróbálkozásra biztonságossá: ha egy kérés időtúllépésbe fut, új számla létrehozása előtt keresse meg a meglévőt hivatkozás alapján, vagy használjon idempotenciakulcsot, ha az átjáró támogatja. Ugyanez a szabály érvényes a kifizetésekre, ahol egy duplikált kérés valódi pénzt küld kétszer.

Az egyeztetéshez tárolja az átjáró számlaazonosítóját, a tranzakció hash-ét, a fiat összeget, a kripto összeget, az árfolyamot és a díjat. Az elszámolási jelentések a kifizetéseket kötegekben sorolják fel, így az egyeztetés a rendeléstől a számlán át a kifizetésig halad, nem a rendeléstől a bankszámlakivonat sorig.

Mit igényel a kifizetési API a Travel Rule alapján?

A kifizetési végpontok kriptót küldenek az átjáró egyenlegéről egy címre, gyakran kötegekben, például partnerjutalékokhoz, piactéri eladóknak vagy ügyfélfelvételekhez. A legtöbb címfehérlistát, kétfaktoros jóváhagyást vagy külön kifizetési jogosultságú API-kulcsot igényel.

Az EU-ban az (EU) 2023/1113 rendelet előírja, hogy az átjáró minden átutalással továbbítsa az átutaló és a kedvezményezett adatait, és 1 000 EUR felett ellenőrizze a saját kezelésű tárcák tulajdonjogát. Számítson rá, hogy a kifizetési kérések tartalmazzák a kedvezményezett nevét és a cím típusát, és tervezzen olyan átutalásokkal, amelyek ezekre az adatokra várakoznak.

Milyen white label kripto fizetési átjáró lehetőségek vannak?

A saját kereskedőinek fizetést újraértékesítő platformok gyakran a saját márkájukkal szeretnék a fizetési oldalt. Három szint van, és az ár a kontrollal együtt nő. A Plisio például 0,5%-ot ad meg az API-jára és 1,5%-ot a white labelre, a NOWPayments pedig külön white label terméket árul.

A teljes white label nemcsak a márkát, hanem a felelősséget is áthelyezi. Ha kereskedőket vesz fel és az egyenlegüket kezeli, szükség lehet saját MiCA-engedélyre; ha egy engedélyes átjáró sub-merchant modelljét használja, ez a kötelezettség az átjárónál marad.

Hogyan kapcsolja be a kripto átjáró API-kat az OrsunPayen keresztül?

Az OrsunPay egységesíti a kripto átjárók státuszait, webhookjait és visszatérítéseit egyetlen API-ban a kártya- és banki szolgáltatók mellett, az Ön saját átjáró-fiókjait használva. Nem tart kriptót, és nem futtat kifizetéseket a saját egyenlegéről; a kéréseket az Ön által választott átjáróhoz irányítja, és aláírt, duplikációmentesített eseményeket ad vissza.

Hogyan integráljon egy kriptovaluta fizetési átjáró API-t

1. Nyisson sandbox fiókokat Hozzon létre sandbox és éles fiókot az átjárónál, generáljon külön API-kulcsot a számlákhoz és a kifizetésekhez, és állítsa be az IPN titkot.
2. Képezze le a státuszokat Fordítsa le az átjáró státuszait a belső állapotaira, és döntse el, melyik adja ki az árut.
3. Hozzon létre számlákat idempotensen Küldje el a fiat összeget, a pénznemet, a rendelési hivatkozást és a callback URL-t; időtúllépéses hívás újrapróbálása előtt keressen hivatkozás alapján.
4. Ellenőrizze az értesítéseket Ellenőrizze az aláírást, kérdezze le újra a számlát az API-ból, és az eseményt egyszer dolgozza fel.
5. Kezelje a szélsőséges eseteket Valósítsa meg a tolerancia, a kiegészítés, a visszatérítés és a lejárat folyamatait, és mindegyiket tesztelje a sandboxban.
6. Egyeztesse az elszámolásokat Számlánként tárolja a tranzakció hash-ét, az árfolyamot és a díjat, és naponta egyeztesse a kifizetési kötegeket a rendelésekkel.