Předstartovní příručka a krok za krokem video rozbor
Otázka {{n}} z {{t}}
Připraveno k uvedení do provozu
Váš tým má odpovědi na klíčové otázky. Jste blízko spuštění: proveďte své testy s reálnými platbami před uvedením do provozu.
Téměř hotovo
Zbývá několik mezer. Uzavřete je před spuštěním: každá z nich je pokryta v části tohoto článku.
Ještě nejsme připraveni
Několik klíčových rozhodnutí je stále otevřených. Hosted Checkout přebírá většinu práce z vašeho týmu a můžete požádat o živou ukázku od prodejního týmu Volet.com, abyste nejprve viděli tok plateb.
Kontrolní seznam před spuštěním API
Devět otázek, na které je třeba odpovědět před uvedením do provozu. Vyberte odpověď, která vyhovuje vašemu týmu: každá odpověď otevře krátkou poznámku a odkazuje na část tohoto článku, která to vysvětluje.
Otázka 1 z 9
1. Vyžaduje produkt vlastní uživatelské rozhraní pro platby?
Ano, potřebujeme naše vlastní UI
Ne, hostovaná stránka funguje
Ještě nebylo rozhodnuto
Pokud ano, potřebujete pouze API a váš tým vytváří a udržuje platební obrazovky. Pokud ne, Hosted Checkout je méně náročná cesta a také přijímá platby z zůstatků účtu Volet.com.
→ Viz: API nebo Hosted Checkout: praktické srovnání, níže
2. Musíme kontrolovat každý krok platebního procesu, nebo je přesměrování přijatelné?
Musíme kontrolovat každý krok
Přesměrování je v pořádku
Ještě nebylo rozhodnuto
S přesměrováním na Hosted Checkout, Volet.com posílá notifikace o stavu na vaši URL stavu. S vlastním uživatelským rozhraním pro platby na API musí váš backend kontrolovat stav platby sám.
→ Viz: API nebo Hosted Checkout: praktické srovnání, níže
3. Máme kapacitu vybudovat a udržovat platební rozhraní, zpracování expirace a kontroly stavu?
Ano, máme kapacitu
Ne, Hosted Checkout nám lépe vyhovuje
Ještě si nejsme jisti
Pouze API znamená, že váš tým vlastní platební obrazovky, expiraci faktur (sazba faktury je platná po dobu 60 nebo 15 minut) a pravidelné kontroly stavu.
→ Viz: Co váš tým skutečně potřebuje vybudovat, níže
4. Definovali jsme, jak interní objednávky odpovídají pokusům o platbu a jak bude zabráněno duplicitnímu plnění?
Ano, je to definováno
Ještě ne
Udržujte každou objednávku oddělenou od jejích pokusů o platbu, použijte jedinečné orderId pro každý pokus a splňte každou objednávku pouze jednou.
→ Viz: Model objednávek a plateb na backendu, níže
5. Rozhodli jsme se, jak vyrovnat transakce poskytovatele, přijaté částky, poplatky a měnu vyrovnání?
Ano, máme proces
Ještě ne
Uložte ID transakce Volet.com, přijatou částku a měnu vyrovnání s každou objednávkou, aby každá platba odpovídala faktuře.
→ Viz: Model objednávek a plateb na backendu, níže
6. Naplánovali jsme si scénáře selhání, end-to-end QA a monitorování produkce?
Ano, je to v plánu
Ještě ne
Odhadněte šťastnou cestu a cesty selhání odděleně: časové limity, vypršené faktury a opakované pokusy vyžadují skutečný inženýrský čas.
→ Viz: Odhadněte práci realisticky, níže
7. Rozhodli jsme se, jak zacházet s nedoplatky, přeplatky, pozdními platbami a platbami zaslanými přes nesprávnou síť?
Ano, naše pravidla jsou nastavena
Ještě ne
Nastavení brány rozhoduje, zda jsou nedoplatky a přeplatky přijímány. Platby zaslané přes nesprávnou síť mohou být ztraceny. Zapište svá pravidla a zásady vracení peněz do svých obchodních podmínek.
→ Viz: Jak se kryptoměnové platby liší od plateb kartou, níže
8. Ví finance, v jaké měně se platby vyrovnávají a jak je stanovena cena za konverzi?
Ano, finance to ví
Ještě ne
Můžete si ponechat kryptoměnu, kterou obdržíte, nebo ji automaticky převést. USD, USDT a USDC se převádějí za pevnou sazbu 1:1; jiné konverze jsou zpoplatněny zvlášť.
→ Viz: Co to stojí s Volet.com, níže
9. Naplánovali jsme, jak testovat s reálnými platbami, vzhledem k tomu, že neexistuje žádný sandbox?
Ano, máme plán testování
Ještě ne
Volet.com nemá žádný sandbox. Požádejte o živou ukázku, vytvořte bránu brzy a testujte s reálnými platbami před spuštěním.
→ Viz: Testování bez sandboxu, níže
Váš výsledek
Odpovězte na všech devět otázek, abyste viděli svůj výsledek.
Stále otevřené:
Jak se kryptoměnové platby liší od plateb kartou
Pokud váš tým již integroval platby kartou, některé zvyky se nepřenášejí. U karet obchodník účtuje zákazníkovi. U kryptoměn zákazník posílá prostředky ze své vlastní peněženky a váš systém musí reagovat na to, co skutečně dorazí. To mění, co musí integrace zvládat.
Částka se může lišit od faktury. Zákazník může poslat o něco méně nebo více, než bylo požadováno, například kvůli poplatkům za síť nebo rozdílům v směnném kurzu. Rozhodněte se předem, zda přijmete nedoplatek a přeplatek.
Například můžete přijmout malé rozdíly, kontaktovat zákazníka nebo vydat refundaci. Ať už se rozhodnete jakkoli, uveďte to ve svých obchodních podmínkách spolu s pravidly pro vracení peněz a kdo platí poplatek za síť při vrácení.
Síť je důležitá. Stejný token existuje na několika blockchainech. Prostředky zaslané přes nesprávnou síť nebo na nesprávnou adresu mohou být ztraceny.
Platnost nabídky vyprší. Fakturační sazba je platná po dobu 60 minut, pokud se vyrovnáváte ve stejné měně, a po dobu 15 minut, pokud je potřeba konverze. Zákazník, který platí pozdě, může potřebovat novou žádost o platbu.
Potvrzení trvá čas. Prostředky jsou připsány až po potvrzení platby blockchainem, takže vaše rozhraní a logika objednávek musí zvládnout čekání.
Neexistují žádné chargebacky a žádné automatické zrušení. Potvrzená on-chain transakce nemůže být zrušena. Refundace je samostatná platba podle vaší vlastní politiky a platných pravidel ochrany spotřebitele.
Vyrovnání je obchodní rozhodnutí. Prostředky jsou připsány na váš účet Volet.com, jakmile platba dokončí. Můžete si ponechat kryptoměnu, kterou jste obdrželi, nebo ji automaticky převést na stablecoiny nebo fiat, aby finance mohly vyrovnat v jedné měně a vyhnout se volatilitě.
Potvrzení sítě zpracováváme za vás. Volet.com sleduje blockchain, čeká na požadovaná potvrzení a připisuje prostředky, takže váš backend nemusí sledovat bloky nebo počty potvrzení.
Jedna rovnováha stablecoinu napříč sítěmi. Stablecoin přijatý na jedné síti lze vybrat prostřednictvím jiné podporované sítě bez samostatné služby pro křížové mosty.
Žádná rezervní částka. Volet.com nezadržuje část vašich dokončených plateb jako rezervu.
Vaše pravidla pro nedoplatky a přeplatky. V nastavení brány rozhodujete, zda přijmout platby, které jsou pod nebo nad částkou faktury. Například pokud zákazníci dobíjejí zůstatek u vás, můžete přesně připsat to, co dorazilo, a přijmout nedoplatky. Při přeplatku je na váš účet připsána pouze částka objednávky.
Zpracování pozdních plateb. Pokud platba dorazí po vypršení platnosti faktury, Volet.com ji buď vrátí zákazníkovi, nebo v některých případech přičte na váš účet.
Peníze dovnitř, peníze ven. Stejný zůstatek Volet.com může financovat vaše odchozí platby: hromadné výplaty dodavatelům, tvůrcům nebo partnerům, nebo výběry pro vaše vlastní uživatele. Například burza může přijímat kryptodepozity uživatelů a zpracovávat jejich kryptovýběry ze stejného zůstatku Volet.com prostřednictvím API.
Volet.com pomůže vybudovat globální platby
Ve fiatu, kryptu i stablecoinech. Přes API, hosted checkout nebo pluginy se snadnou instalací. Přijímejte, posílejte a spravujte peníze – vše z kódu.
Klíčovým rozhodnutím je, kolik z platebního zážitku musí váš produkt vlastnit — a kolik inženýrského úsilí jste ochotni do něj investovat.
Vyberte pouze API, když potřebujete vlastní platební UI a kontrolu nad celým platebním procesem. Vaše aplikace vlastní každý krok, který zákazník vidí, od zobrazení platebních pokynů až po informování zákazníka, dokud není platba potvrzena nebo nevyprší. Váš tým to všechno vytváří a udržuje.
Vyberte Hosted Checkout, když není vyžadováno vlastní uživatelské rozhraní pro platby a plná kontrola nad každým krokem. Volet.com hostí platební stránku, což obvykle činí tuto cestu jednodušší a méně náročnou. Funguje také uvnitř Telegram botů a mini aplikací, kde se platební stránka otevírá v okně prohlížeče v aplikaci (webview).
Můžete také kombinovat Hosted Checkout s API pro vyhledávání objednávek a vyrovnání. V každém případě Hosted Checkout stále vyžaduje backendovou práci. Vaše aplikace si uchovává vlastní záznamy o objednávkách a porovnává je se stavem platby na straně Volet.com. Váš backend také podepisuje požadavky, které posílá do Hosted Checkout, což pomáhá chránit před manipulovanými požadavky, které by mohly přesměrovat platbu zákazníka mimo váš obchod.
Rozhodovací faktor
Pouze API
Hosted Checkout
Uživatelské rozhraní pro platby pro zákazníky
Vytvořeno a udržováno vaším týmem
Hostováno Volet.com
Kontrola nad platebním procesem
Vysoká: vaše aplikace vlastní zkušenost
Více omezené: zákazník následuje hostovaný tok
Inženýrské úsilí
Vyšší: UI, kontroly stavu, expirace a okrajové případy
Nižší pro platební UI; backend stále podepisuje platební požadavky, zpracovává oznámení a aktualizuje objednávky
Nejlepší volba
Vlastní pokladna na webu nebo v aplikaci, botu nebo platformě
Standardní platební tok, kde je přesměrování na hostovanou stránku přijatelné, včetně Telegram botů a mini aplikací
Zpracování stavu
Backend kontroluje stav platby prostřednictvím API
Oznámení o URL stavu plus API vyhledávání pro vyrovnání podle potřeby
Platba z zůstatku účtu Volet.com
Není k dispozici: pouze API přijímá krypto z externích peněženek
Dostupné: zákazníci mohou platit ze svého zůstatku účtu Volet.com, poplatek 0,25%
Koncové body faktur jsou pouze jednou částí implementace pouze API. Před závazkem k tomu zohledněte níže uvedené produktové a provozní odpovědnosti.
Jak funguje tok s pouze API:
Vytvořte objednávku ve svém systému.
Vytvořte kryptofakturu prostřednictvím API.
Ukažte zákazníkovi adresu, částku, měnu, síť a čas vypršení, které vrátilo API.
Zákazník odešle platbu ze své peněženky.
Váš backend kontroluje stav platby prostřednictvím API.
Jakmile je platba potvrzena, označte objednávku jako zaplacenou a splňte ji.
Jak funguje tok s Hosted Checkout a API:
Vytvořte objednávku ve svém systému a přesměrujte zákazníka na Hosted Checkout s vaším orderId.
Zákazník platí na stránce Hosted Checkout.
Volet.com odešle oznámení na vaši Status URL, koncový bod na vašem serveru, který přijímá aktualizace plateb.
Váš backend ověřuje podpis a v případě potřeby potvrzuje objednávku prostřednictvím API.
Označte objednávku jako zaplacenou a splňte ji.
Uživatelské rozhraní pro platby a životní cyklus faktury. Vaše aplikace musí přesně zobrazit platební údaje vrácené API: částku k odeslání, měnu, blockchainovou síť, adresu, jakýkoli cílový tag nebo poznámku a čas vypršení. Měla by varovat zákazníky, aby odesílali prostředky pouze prostřednictvím určené sítě. Nesprávné pokyny k platbě mohou vést ke ztrátě prostředků, takže to je funkční požadavek, nikoli vizuální detail.
Neposílejte zákazníkovi informaci, že platba selhala nebo byla dokončena, dokud ji nepotvrdí stav platby.
Model objednávek a plateb na backendu. Udržujte svou interní objednávku oddělenou od pokusu o platbu nebo faktury. To usnadňuje zpracování opuštěných pokladen, vypršených faktur, zákazníků, kteří se pokoušejí znovu, a aktualizací stavu, které přicházejí poté, co uživatel opustil stránku.
Použijte unikátní orderId pro každý pokus o platbu, jak popisuje dokumentace API. Definujte ve své vlastní databázi, jak se každý pokus mapuje na objednávku. Uložte ID transakce Volet.com, přijatou částku a měnu vyrovnání s každou objednávkou, aby finance mohly přiřadit každou platbu k faktuře bez manuálních tabulek. Daňové zacházení s příjmy z kryptoměn závisí na vaší jurisdikci, proto se na tom dohodněte se svým účetním.
Vyberte model částky faktury. Rozhodněte, zda je objednávka oceněna v měně, kterou očekáváte, nebo zda by zákazník měl odeslat pevnou částku konkrétní kryptoměny. Tato volba ovlivňuje zobrazení ceny, vyrovnání a způsob, jakým vysvětlujete dlužnou částku. Upravte to podle svého cenového a účetního modelu a ověřte vypočítané hodnoty před vytvořením živých faktur. Dokumentace API vysvětluje, jak nastavit každou možnost.
Představte si, že váš zákazník zadá objednávku na 120 € a zaplatí v kryptoměně. Váš backend by měl uchovat dostatek informací, aby mohl přiřadit dokončenou platbu k původní objednávce. Pro tuto platbu by uchovával:
Vaše ID objednávky (ORD-10482) identifikuje nákup ve vašem systému.
ID transakce Volet.com (VLT-839201) spojuje platbu s transakcí na straně Volet.com.
Přijatá částka (přibližně 139 USDT) ukazuje, co zákazník skutečně poslal.
Měna vyrovnání (EUR) zaznamenává měnu, ve které účtuje váš finanční tým.
Stav platby (konečný, potvrzený API) vám říká, zda může být platba považována za dokončenou.
Pro srovnání přiřaďte transakci Volet.com k vaší pokusu o platbu a objednávce, poté porovnejte ID transakce, očekávané a přijaté částky, měnu a konečný stav platby. Pokud platba chybí, je pozdní nebo neodpovídá očekávané částce, označte ji k prošetření místo automatického označení objednávky jako zaplacené.
Zákazník vytvoří objednávku, otevře platební stránku a odešle požadovanou kryptoměnu. Předtím, než blockchain potvrdí transakci, zavře kartu prohlížeče a opustí vaši webovou stránku.
Váš backend pokračuje v sledování platby:
Zákazníkova objednávka zůstává čekající ve vašem systému.
Pokus o platbu pokračuje nezávisle. Při použití pouze API váš backend kontroluje jeho stav prostřednictvím API. Při použití Hosted Checkout, Volet.com odešle oznámení na vaši Status URL.
Váš backend ověřuje stav platby prostřednictvím API.
Jakmile je platba potvrzena jako dokončená, váš systém označí objednávku jako zaplacenou a spustí její vyřízení.
Pokud se zákazník vrátí na vaši webovou stránku, uvidí aktualizovaný stav objednávky.
Důležitý bod: zavření stránky pokladny nezruší platbu ani ji nepotvrdí. Váš backend, nikoli přesměrování prohlížeče, určuje, kdy může být objednávka splněna.
Správa stavu a zotavení. Při použití pouze API musí váš tým zvolit strategii dotazování (jak často backend kontroluje stav), vyhnout se zbytečným požadavkům a zvládat dočasné selhání vyhledávání, aniž by nesprávně změnil stav objednávky.
Považujte oznámení za signál, nikoli za důkaz platby: ověřte jeho podpis a vyhledejte objednávku prostřednictvím API před jejím splněním. Zpracovávejte každou objednávku pouze jednou, klíčovanou vaším vlastním orderId, takže opakované oznámení nebo druhá kontrola stavu ji nemohou splnit dvakrát.
Objednávku splňte pouze poté, co API potvrdí, že platba je dokončena, nikoli když se vytvoření faktury podaří nebo když se prohlížeč přesměruje. Přesné hodnoty stavu a jak s každým z nich zacházet jsou popsány v dokumentaci API.
A request can time out even when the remote system has processed it. Do not blindly retry invoice creation after an ambiguous failure. Before deciding what to do next, log the API's errorId, check the existing order and payment state, and follow the documented error handling. Never create a duplicate order automatically, and retry a request only when it is safe to do so.
Bezpečnost a provozní připravenost. Uchovávejte tajemství API a autentizační údaje na serveru. Nikdy je neodhalujte v kódu na straně klienta, mobilních aplikacích, botech nebo skriptech na straně klienta. Nakonfigurujte pouze oprávnění požadovaná integrací a omezte přístup k API na IP adresy vašich serverů: povolení všech IP adres se v produkci nedoporučuje.
Návrh spolehlivého platebního toku
Platební tok musí zvládat více než jen úspěšný případ.
Rozhodněte, co by měl produkt dělat, když:
vyprší čas na vytvoření faktury a výsledek je neznámý;
dočasně selže vyhledávání stavu;
faktura vyprší, než zákazník zaplatí;
zákazník opustí pokladnu a později se vrátí;
zákazník zahájí další pokus o platbu;
oznámení o stavu je zpožděno nebo přijato více než jednou.
Cílem je vyhnout se duplicitnímu splnění, udržet interní stav objednávky konzistentní a poskytnout zákazníkovi jasný další krok.
Volet.com nemá sandbox ani testovací prostředí. Naplánujte to brzy, místo abyste to objevili při spuštění:
Požádejte o živou ukázku od prodejního týmu Volet.com, abyste viděli platební tok, API a Hosted Checkout předtím, než začnete stavět.
Vytvořte bránu brzy. Nová spravovaná brána (ta, kde Volet.com drží přijaté prostředky na vašem účtu) prochází kontrolou souladu, která obvykle trvá několik hodin, a mezitím můžete dokončit integraci.
Testujte s reálnými platbami v produkci: úspěch, selhání, vypršení, nedoplatek a přeplatek. Každá testovací platba v kryptoměně je skutečná transakce na blockchainu s poplatkem za síť.
Pro Hosted Checkout také zkontrolujte doručení URL stavu, ověření podpisu a přesměrování na úspěch a selhání.
Označte testovací objednávky ve své databázi, aby se nemíchaly s reálnými příjmy během smíření.
Odhadování práce realisticky
Skutečná námaha závisí na vaší stávající architektuře pokladny, požadované uživatelské zkušenosti, zkušenostech vašich inženýrů s platebními API a rozsahu testování (QA).
Pracovní tok
Pouze API
Hosted Checkout
Nastavení účtu a brány
Ověření účtu, konfigurace API, oprávnění a schválení
Ověření účtu, konfigurace Hosted Checkout a jakékoli požadované schválení
Hlavní implementace
Vytváření faktur, uživatelské rozhraní pro platby, kontroly stavu a aktualizace objednávek
Přesměrovací tok, zpracování URL stavu a aktualizace objednávek na backendu
Okrajové případy
Vypršení, nejasné časové limity, opakování, duplicitní pokusy a síťové pokyny
Ověření oznámení, okrajové případy přesměrování a vyrovnání
QA
Zobrazení podrobností o platbě, kontrola stavu, vypršení, selhání a obnova
Přesměrování, doručování oznámení, ověření podpisu a vyrovnání
Probíhající vlastnictví
Údržba UI, monitorování, diagnostika podpory a zpracování stavu
Monitorování backendu, vyrovnání objednávek a operace zpětného volání
Odhadněte úspěšnou cestu a cesty selhání odděleně a zahrňte čas na testování od začátku do konce a monitorování produkce.
Co to stojí s Volet.com
Od 0,25 % za platby stablecoiny a kryptoměnami. Konverze mezi USD, USDT a USDC probíhá za pevný kurz 1:1; ostatní konverze jsou cenově stanoveny zvlášť. Zákazník platí poplatek za blockchainovou síť. Žádný poplatek za nastavení a žádný měsíční poplatek. Vy si vybíráte, kdo zaplatí poplatek za zpracování. Vysoké objemy mohou kvalifikovat na individuální ceny prostřednictvím prodeje.
Přijímejte USDT, USDC a hlavní krypto tokeny po celém světě
Začněte s platební branou pro krypto – okamžité vypořádání a poplatky od 0,25%
Ne. Volet.com nemá testovací prostředí. Můžete požádat o živou ukázku od prodejního týmu. Otestujte úspěch, selhání, vypršení, nedoplatky a přeplatky na své straně před spuštěním.
Nové úschovny pro brány procházejí nejprve kontrolou souladu. Obvykle to trvá několik hodin. Váš účet musí být ověřen, než vytvoříte bránu. Využijte čekací dobu k dokončení integrace.
Ne. S API pouze váš backend sám kontroluje stav platby. Pokud potřebujete oznámení, použijte Hosted Checkout spolu s API.
Nastavení vaší brány rozhoduje o tom, zda jsou akceptovány nedoplatky a přeplatky. Pokud platba dorazí po vypršení faktury, Volet.com ji buď vrátí zákazníkovi, nebo ji v některých případech přičte na váš účet. Zákazník, který stále chce zaplatit, může potřebovat novou žádost o platbu.
Podívejte se na objednávku prostřednictvím API podle vašeho orderId, než odpovíte.
Převod může být viditelný na blockchainu a přesto nemusí odpovídat faktuře: může být krátký, pozdní nebo odeslán přes jinou síť.
Dejte svému podpoře přístup k podrobnostem o platbě a předem se dohodněte, kdy eskalují případ na podporu Volet.com.
Ne. Potvrzenou transakci na blockchainu nelze zrušit a neexistují žádné chargebacky z karet. Vrácení peněz je samostatná platba podle vaší vlastní politiky a platných pravidel ochrany spotřebitele.
Ne. Volet.com neposkytuje akvizici karet. Držte si svého poskytovatele karet pro přímé platby kartou.