API na vydávanie krypto kariet: Praktický sprievodca fungovaním

Budovanie kartového programu starým spôsobom znamená, že sponzorská banka, spracovateľ, personálizačné oddelenie a funkcia dodržiavania predpisov zostavujú jednu zmluvu po druhej. Ľudia uvádzajú, že to trvá osemnásť mesiacov.

API pre vydávanie kariet je argumentom, že už nemusíte. Táto práca nezmizne, ale skôr sa jej väčšina presunie na účet niekoho iného a to, čo zostane, je dobré pochopiť predtým, ako podpíšete zmluvu.

Kľúčové poznatky

• Rozhranie API na vydávanie krypto kariet umožňuje firme vytvárať a spravovať platobné karty prepojené s krypto zostatkami, zvyčajne bez toho, aby mala vlastnú licenciu na kartu, bankové sponzorstvo alebo procesný stack.
• Spoločnosť UPay Business vydáva fyzické a virtuálne karty Visa prostredníctvom jediného API, poplatky za kryptomenové platby sú pod 1 percentom v porovnaní s 3 až 5 percentami, ktoré účtuje za tradičné cezhraničné platby, a akceptuje BTC, ETH, USDT a viac ako 50 ďalších aktív v rámci TRC20, ERC20 a BSC.
• Spoločnosť UPay Business zverejňuje približne päť minút pre vyrovnanie kryptomien a T+0 alebo T+1 pre výplatnú vetvu fiat meny v závislosti od kanála, pričom bankové vyrovnanie je T+1. Ide o rôzne vetvy, nie je to protiklad, preto sa opýtajte, na ktorej vetve končí váš koridor.
• Vlastná dokumentácia pre vývojárov spoločnosti UPay zverejňuje testovacie prostredie, 60-sekundové okno platnosti podpisu na žiadosť a povinný zoznam povolených IP adries a uvádza svoju základnú produkčnú URL adresu ako nezverejnenú.
• Dodržiavanie predpisov, ktoré zdedíte, je skutočné: overovanie totožnosti, monitorovanie transakcií, preverovanie sankcií, cestovné pravidlo vo výške 3 000 amerických dolárov v Spojených štátoch a norma PCI DSS v4.0.1, ktorá je v súčasnosti jedinou aktívnou verziou a ktorej 51 požiadaviek s budúcim dátumom nadobudlo účinnosť 31. marca 2025.
• Pokiaľ ide o registrácie, vezmite si to, čo uvádza samotný UPay: licenciu prevádzkovateľa peňažných služieb v Hongkongu, zásadné schválenie litovského poskytovateľa služieb virtuálnych aktív a registrácie firiem poskytujúcich peňažné služby v Spojených štátoch a Kanade.

Čo je API na vydávanie krypto kariet

API na vydávanie krypto kariet je sada programovateľných koncových bodov, ktoré umožňujú firme vytvárať, financovať, zmrazovať a rušiť platobné karty viazané na krypto zostatok zákazníka bez toho, aby vlastnila príslušné zariadenie.

Poskytovateľ si ponecháva vzťahy, ktoré je ťažké získať: členstvo v sieti, spôsob vydania, spracovanie a konverziu. Vy si ponechávate zákazníka, značku a pravidlá výdavkov.

V kroku konverzie sa nachádza krypto časť. Karta je bežná karta v bežnej sieti; to, čo poskytovateľ pridá, premení krypto zostatok na zúčtovaciu menu pri autorizácii, takže obchodník vidí bežnú transakciu a zákazník krypto debet.

Ako funguje tok, krok za krokom

Nástupné kontroly a kontroly identity. Vaša aplikácia zhromažďuje údaje o zákazníkovi a odosiela ich prostredníctvom overovacích koncových bodov poskytovateľa. Výsledok sa vracia asynchrónne, preto ho zostavujte pre stav „čaká sa“ a nie pre stav „áno“ alebo „nie“.

Financovanie zostatku. Zákazník prevedie kryptomenu na účet, z ktorého je karta pripísaná. V UPay ide o dobitie z peňaženky UPay, nie o inkaso, takže zostatok si zákazník neustále dopĺňa.

Vydanie a poskytnutie. Virtuálna karta sa vydáva rýchlo. Fyzická karta sa musí vyrobiť a odoslať, a preto koncové body kariet UPay zahŕňajú aktiváciu a sledovanie logistiky popri registrácii.

Autorizácia. Keď zákazník zaplatí, sieť odošle žiadosť o autorizáciu, poskytovateľ skontroluje zostatok a vaše pravidlá pre výdavky, prevedie ich a schváli alebo zamietne. Všetko, čo chcete kontrolovať, je potrebné nastaviť vopred.

Vyúčtovanie a zosúladenie. Zúčtované transakcie sa vyúčtujú obchodníkovi prostredníctvom siete, zatiaľ čo vaša strana ich zosúladí s webhookmi. Kanál webhookov je záznam a dashboard je súhrn.

Naša poznámka o fungovaní platieb USDT sa zaoberá tým, čo vám potvrdenie reťazca v skutočnosti hovorí, čo je vstupom do tohto zosúladenia.

Čo dokumentácia API UPay skutočne publikuje

Tu je to, čo uvádza dokumentácia pre vývojárov a obchodné stránky spoločnosti UPay.

Čo sa kupujúci pýta	Čo UPay publikuje vo vlastných materiáloch	Kde sa to hovorí
Ktoré karty môžem vydať?	Fyzické a virtuálne karty Visa prostredníctvom jedného rozhrania API	Firemná stránka UPay
Je tam pieskovisko?	Testovacie prostredie je publikované; testovanie je uvedené ako nedostupné a URL adresa produkčnej základne nie je verejne zverejnená.	Referencia API UPay
Ako sa overuje autentifikácia žiadosti?	Každá požiadavka je podpísaná a podpis je platný 60 sekúnd, potom je potrebné ho regenerovať.	Referencia API UPay
Existujú nejaké sieťové obmedzenia?	Volajúce IP adresy musia byť na zozname povolených a odpovede prichádzajú iba z určených adries.	Referencia API UPay
Čo môžem urobiť s kartou?	Registrácia, aktivácia, dobitie, uzamknutie a odomknutie, zrušenie, vyžiadanie faktúr, nastavenie obchodného hesla, sledovanie logistiky, potvrdenie 3-D Secure, autorizácia sumy výdavku	Referencia API UPay
Čo ešte pokrýva API?	Obchodník, Účet, Skupina zákazníkov, Zákazník, Adresa, Karta, Peňaženka, Nadobúdateľ, Výdavok, IFrame, nahrávanie súborov, zoznam regiónov, zoznam kódov a skupiny webhookov	Referencia API UPay
Je dokumentácia v angličtine?	Primárny zdroj je v zjednodušenej čínštine; kompletný anglický mirror je zverejnený na stránke upay-api-en.readme.io (https://upay-api-en.readme.io/)	Referenčná príručka k UPay API, obe vydania
Ako zistím, že sa niečo stalo?	Upozornenia webhooku pre udalosti karty, peňaženky, získavania a platieb	Referencia API UPay
Koľko stojí spracovanie?	Menej ako 1 percento pri krypto platbách, v porovnaní s 3 až 5 percentami uvádzanými pri tradičných cezhraničných platbách	Firemná stránka UPay
Ako rýchlo sa peniaze vyrovnávajú?	Približne 5 minút v reťazci („~ 5 minút“); výplata fiat meny T+0 alebo T+1 v závislosti od kanála; bankové vyrovnanie T+1	Stránka UPay Business a jej stránka pre platby v kryptomenách

Predtým, ako sa pustíte do rozsahu práce, sa oplatí prečítať si obe: zoznam povolených položiek obmedzuje, kde sa váš kód spúšťa, a 60-sekundové okno podpisu obmedzuje spôsob opakovaných pokusov.

Spoločnosť UPay Business zverejňuje približne päť minút na vyrovnanie kryptomien, čo predstavuje „~ 5 minút“ oproti 1 až 5 pracovným dňom pre tradičné platby v rámci Rails, zatiaľ čo jej stránka s platbami v kryptomenách uvádza, že vyrovnanie v reťazci „je možné dokončiť v reálnom čase, zatiaľ čo vyrovnanie fiat mén je zvyčajne T+0 alebo T+1 v závislosti od výplatného kanála“, pričom bankové vyrovnanie je uvedené ako T+1.

Rýchly prehľad je časť reťazca a T+0 alebo T+1 je časť výplaty fiat meny, takže sa opýtajte, na ktorej časti váš koridor skutočne končí. UPay tiež zverejňuje jediný údaj o návratnosti investícií v tejto kategórii: úspora 20 000 až 50 000 amerických dolárov na milión spracovaných v porovnaní s tradičnými bankovými systémami.

Súlad, ktorý zdedíte

Technológia funguje v rýchlom tempe. Súbor o zhode trvá štvrťrok a určuje dátum spustenia.

Overenie totožnosti. Vydávanie karty je regulovaná činnosť na každom trhu, ktorá je dôležitá pre kartový program, takže každý držiteľ karty je overený ešte pred jej existenciou. UPay zverejňuje koncové body odoslania, dopytu a priebehu, takže váš produkt musí vykazovať stav medzi aplikovaným a schváleným.

Náš vysvetľujúci článok o dodržiavaní predpisov v oblasti kryptomien „poznaj svojho zákazníka“ vysvetľuje, na čo slúžia kontroly.

Monitorovanie transakcií a sankcie. Skríning sa vykonáva na základe mien a v prípade kryptomenovej vetvy aj na základe adries peňaženiek. Úrad pre kontrolu zahraničných aktív amerického ministerstva financií uvádza adresy virtuálnych mien na svojom zozname sankcií od roku 2018, takže adresa je preverovateľný identifikátor rovnako ako meno.

UPay uvádza svojich infraštruktúrnych partnerov, čo je viac ako väčšina poskytovateľov: overenie identity so spoločnosťou Sumsub, ktorú UPay oznámila v máji 2024 , vysporiadanie stablecoinov so spoločnosťou StraitsX a cloudová infraštruktúra so spoločnosťou Tencent Cloud. Všetci traja sú uvedení na UPay Business v časti „Postavené na dôveryhodných globálnych partnerstvách“. Menovaných partnerov je možné skontrolovať; „infraštruktúra podnikovej úrovne“ nie.

Cestovné pravidlo. V Spojených štátoch vyžaduje 31 CFR 1010.410(f) informácie o pôvodcovi a príjemcovi pri cestovaní s prevodmi 3 000 amerických dolárov alebo viac. Toto pravidlo predchádza kryptomenám a vzťahuje sa na ne.

PCI DSS. Zabezpečenie údajov na kartách funguje na základe štandardu bezpečnosti údajov odvetvia platobných kariet (Payment Card Industry Data Security Standard). Rada pre štandardy bezpečnosti odvetvia platobných kariet (Payment Card Industry Security Standards Council) ukončila podporu verzie 4.0 k 31. decembru 2024, takže verzia 4.0.1 je teraz jedinou aktívnou verziou.

Zo 64 požiadaviek zavedených vo verzii 4.x bolo 51 dátumovaných do budúcnosti a nadobudli účinnosť 31. marca 2025 , takže dnešné hodnotenie sa týka skôr celého súboru než prechodného.

Používanie polí hostovaných na karte poskytovateľa zužuje váš rozsah. Neodstraňuje ho a otázka, ktorú si audítor položí, je, ktorých polí sa váš vlastný kód vôbec dotkne.

Licencie. Vyžiadajte si zoznam a overte si ho v oficiálnych registroch, nie na marketingovej stránke. UPay uvádza licenciu prevádzkovateľa peňažných služieb v Hongkongu, zásadné schválenie poskytovateľa služieb virtuálnych aktív v Litve a registrácie firiem poskytujúcich peňažné služby v Spojených štátoch a Kanade.

Spoločnosť UPay zverejnila identifikátory pre tieto dva subjekty: 31000257909666 pre registráciu v USA a M24993747 pre kanadskú. Vyhľadajte si ich sami vo vyhľadávaní registrantov MSB od FinCEN a v registri MSB od FINTRAC a ak sa v niektorom z nich nezobrazí subjekt, s ktorým uzatvárate zmluvu, skôr ako pôjdete ďalej, opýtajte sa prečo.

Dve vlastné stránky UPay sa v tomto smere nezhodujú. Na domovskej stránke sú štyri uvedené ako pozastavené; na stránke „O nás“ sú stále uvedené na časovej osi „Ciele a plány“ ako licencie, ktoré je potrebné získať, s dátumom 3. štvrťrok 2023 a 1. štvrťrok 2024, spolu s licenciou na zverenectvo, ktorú domovská stránka neuvádza.

To je bežný stav marketingu predajcov a dôvodom, prečo je odpoveďou skôr register než stránka.

Výzvy pri používaní API na vydávanie krypto kariet

Pravidlá sa líšia podľa trhu a štátnej príslušnosti. Jedno API vám neponúka jeden produkt. Zoznamy sankcií, pravidlá siete a vlastný zoznam krajín poskytovateľa ovplyvňujú, koho môžete obsluhovať.

Konverzné riziko nezmizne, ale presunie sa. Konverzia pri autorizácii sústreďuje expozíciu zákazníka v sekundách okolo každého nákupu. V prípade volatilného finančného aktíva je pokles zostatku, ktorý vyzeral dostatočne ešte pred hodinou, požiadavkou na podporu, nie chybou.

Stále tvoríte tú nudnú polovicu. Vydáva API a kontroluje karty. Výpisy, prijímanie námietok, postup 3-D Secure, pripomienka dobitia a export daní sú vaše. Tímy vymedzujú rozsah koncových bodov a zabúdajú na produkt okolo nich.

Vaši zákazníci potrebujú poučenie. Karta financovaná z peňaženky sa odmietne, keď je zostatok nízky, bez prečerpania a automatického dobitia. Uveďte to v procese registrácie, nie v podmienkach.

Zdedíte stabilitu poskytovateľa. Program kariet nie je závislosť, ktorú môžete zmeniť cez víkend. Opýtajte sa, čo sa stane s platnými kartami, ak poskytovateľ zmení svojho vydávajúceho partnera.

Čo si overiť pred podpisom

Ktoré trhy, akým testom. Oprávnenosť na kartu sa určuje podľa štátnej príslušnosti, nie podľa bydliska, a líši sa v závislosti od karty. Karta Premier od UPay odmieta žiadosti z dlhého zoznamu krajín a území, z ktorých väčšina je neobývaná alebo sporná.

Jeho platinová karta odmieta žiadosti z oveľa kratšieho zoznamu, ale tento zoznam zahŕňa okrem iných Spojené štáty, Čínu, Indiu, Indonéziu, Pakistan, Vietnam, Turecko, Saudskú Arábiu a Izrael. Užší zoznam je ten, ktorý ukončuje obchody a obe karty samostatne úplne zakazujú sankcionované štátne príslušnosti.

Spoločnosť UPay zoznam reviduje a uvádza, že je založený na zoznamoch rizík a sankcií od spoločnosti Visa a hlavných globálnych regulačných zoznamoch, takže aktuálnu verziu si môžete stiahnuť z jej Centra pomoci.

Kto je vydavateľom. Karty UPay vydávajú partnerské inštitúcie, nie samotná spoločnosť UPay, a práve tento subjekt je ten, ktorého pravidlá sú záväzné pre váš program.

Spoločnosť UPay vymenovala jednu z nich: JC Credit Limited, pre svoju hongkonskú kreditnú kartu za podmienok, ktoré odkazujú na Mastercard. Jej súčasné karty Premier a Platinum a vydávanie kariet Business API fungujú na platforme Visa. Opýtajte sa, ktorá spoločnosť vydáva tú vašu.

Aká sadzba sa uplatňuje. Opýtajte sa, aká sadzba sa uplatňuje pri autorizácii, aký je rozdiel a kto znáša rozdiel medzi autorizáciou a vyrovnaním.

Ako sa dostanete von. Opýtajte sa, čo sa stane s držiteľmi vašich kariet, ak odídete, kto vlastní tokenizované prihlasovacie údaje a aké oznámenie sa na vás vzťahuje. Odpoveď sa zriedka nachádza v dokumentácii.

Váženie poskytovateľov namiesto mechanikov? Náš sprievodca platformami vydávania krypto kariet pre startupy ich porovnáva a infraštruktúra B2B krypto platieb pokrýva aj aspekt vyúčtovania.

Čo skutočne zaberá čas

Realistické prvé nasadenie trvá tri až štyri mesiace a len veľmi malá časť z neho je inžinierska: inžinierska činnosť trvá týždne, dokumentácia o zhode trvá štvrťrok. V oboch prípadoch ide skôr o pracovné odhady ako o zverejnené čísla.

Overenie znalosti vášho podnikania v subjekte s viacvrstvovým vlastníctvom je krok, ktorý sa predlžuje. Majte pripravené zakladacie dokumenty, schému vlastníctva a identifikačné údaje riaditeľa.

Potom už ide skôr o rozhodnutia než o kód: ktoré kontroly výdavkov zverejníte, akú podporu vykoná, keď je karta odmietnutá na čerpacej stanici s predautorizačnou blokáciou a ako zákazník dobije vyčerpaný zostatok.

Samotná integrácia je tou krátkou časťou a prejde vás ňou náš sprievodca integráciou API platobnej brány.

Často kladené otázky

Je integrácia API pre vydávanie krypto kariet náročná?

Integrácia nie je najťažšia časť. Dokumentácia, testovacie prostredie a webhooky robia z inžinierstva záležitosť týždňov. Overenie vašej vlastnej spoločnosti, schválenie súladu a obchodné podmienky stanovujú dátum.

Potrebujem vlastnú licenciu na vydávanie kariet prostredníctvom API?

Zvyčajne nie: licencie sú držiteľami poskytovateľa a jeho vydávajúceho partnera a vy pôsobíte ako programový manažér na základe ich povolení. Ide skôr o obchodnú pozíciu ako právny názor, preto si ju overte pre každý trh, ktorému slúžite.

Ako krypto karta zvláda pohyb ceny medzi nákupom a vyrovnaním?

Poskytovateľ vykoná konverziu pri autorizácii, takže zostatok sa odpíše proti kurzu stanovenému v danom okamihu. Rozdiel medzi autorizáciou a vyrovnaním sa niekam prenesie a zmluva uvádza kam.

Aký je rozdiel medzi vydávaním karty a platobnou bránou?

Brána vám umožňuje prijímať peniaze od zákazníkov. Vydávanie karty poskytuje zákazníkom kartu, ktorou môžu platiť. Podobné inštalatérske práce, opačné problémy a veľa firiem chce oboje.

Môžem vydávať karty zákazníkom kdekoľvek?

Nie. Kartový program obsahuje zoznam krajín a národností, ktorým nemôže slúžiť, a to na základe sankcií a pravidiel siete. Predtým, ako sa pozriete na trh, si zistite aktuálny zoznam.