> ## Documentation Index > Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Jak fungují platby v TWICE > Hierarchie plateb, životní cyklus transakcí, kauce, částečné vrácení peněz a podporovaní poskytovatelé v TWICE Commerce. ![Karta Platba na objednávce](https://mintcdn.com/twicecommerce/Ab7tx7ih94KQsi0k/images/order-payment-tab.webp?fit=max\&auto=format\&n=Ab7tx7ih94KQsi0k\&q=85\&s=a5deb37bb18abc87753e7cb6a3860e86) Objednávky > \[Objednávka] > Platba ## Definice TWICE rozděluje pohyb peněz do čtyřúrovňové hierarchie: **Objednávka → Pokladna → Platba → Transakce**. | Úroveň | Co dělá | | :- | :- | | Objednávka | Určuje, co se kupuje nebo pronajímá. | | Pokladna | Sbírá záměr platby. | | Platba | Vytváří daňový doklad. | | Transakce | Skutečný pohyb peněz u platebního poskytovatele. | Vedle plateb stojí **faktury** – zúčtovací dokumenty, které fakturují přesouvané peníze. Vrácení peněz, kauce, částečné platby a rozdělené platební metody se na tuto hierarchii mapují přímočaře. ## Kde to použiji? * Konfigurace platebních poskytovatelů v **Nastavení → Platby** * Účtování zákazníkům u pokladny (online nebo v administraci) * Zpracování kaucí na rentálních objednávkách * Vystavení plného nebo částečného vrácení peněz proti strženým transakcím * Sesouhlasení reportů s výplatami vašeho platebního poskytovatele * Budování API integrací, které potřebují zaznamenávat ruční platby nebo vystavovat vrácení peněz ## Klíčové vlastnosti ### Hierarchie plateb ``` Objednávka > Řádkové položky > Pokladna > Platby > Transakce ``` > **Objednávka** > > Objednávka obsahuje všechny řádkové položky (co si zákazník kupuje nebo pronajímá). Každý platební tok začíná objednávkou. > > Více: [Životní cyklus objednávky](https://www.twicecommerce.com/docs/cs/concepts/orders/order-lifecycle.md) > **Řádkové položky** > > Řádkové položky (Řádková položka představuje jeden konkrétní záznam produktu nebo služby v rámci objednávky a obsahuje příslušné skladové položky, množství, cenu a podrobnosti o vyřízení pro danou část transakce.) reprezentují to, co zákazník kupuje nebo pronajímá. Každá řádková položka odkazuje na: > > * Inzerát (nebo jednorázovou řádkovou položku) > * Množství > * Cenovou informaci > * Přidružené skladové položky (pro vyřízení) > **Pokladna** > > Pokladna (Pokladna vybírá platbu za košík nebo objednávku. Ve výkladní skříni začíná od zákazníkova košíku a po dokončení vytvoří objednávku; z administrace nebo přes odkaz na pokladnu se otevírá k existující objednávce. Pokladna může nést několik plateb, což umožňuje částečné platby.) se vytvoří, jakmile je objednávka připravena k platbě. Pokladnu lze vytvořit: > > * Ručně z objednávky (personálem) > * Samoobslužně online (zákazníkem) > > Pokladna na storefrontu začíná od košíku a při dokončení vytvoří objednávku; pokladna v administraci nebo z odkazu se otevírá proti existující objednávce. V obou případech může mít pokladna připojeno více plateb. > **Platba** > > Platba (Platba je propojena s pokladnou a vytváří daňový doklad. Platby vždy odkazují na řádkové položky objednávky a mohou zahrnovat více transakcí. Pokladna může mít více plateb, což umožňuje scénáře částečných plateb.) je propojena s pokladnou a vytváří daňový doklad. Klíčové vlastnosti: > > * Vždy odkazuje na řádkové položky objednávky > * Může obsahovat více transakcí > * Pokladna může mít více plateb (např. kauce + doplatek) > **Transakce** > > Transakce (Transakce je obdobou účtenky z platebního terminálu. Platba může zahrnovat více transakcí — například rozdělená platba (stravenka + hotovost = 2 transakce, 1 platba) nebo platba s vrácením peněz (původní platba + vrácení peněz = 2 transakce, 1 platba).) je obdobou účtenky z platebního terminálu. Jedna platba může obsahovat více transakcí. > > **Příklady:** > > * **Rozdělená platba**: polovina dárkovou kartou, polovina hotovostí → 2 transakce, 1 platba > * **Vrácení peněz**: původní stržená transakce na původní platbě, transakce vrácení na propojené platbě vrácení ### Typy a metody plateb Každá platba má **typ** a **metodu** popisující způsob úhrady: * **Typy**: `sale` (platba), `deposit_auth`, `deposit_capture`, `refund`, `refund_reverse` (vrácení peněz stržené zpět k vám), `cancel` a `expire` (autorizace, která vypršela nevyzvednutá). * **Ruční metody**: **Platba v prodejně** (`PAY_STORE`) a obchodníkem pojmenované **vlastní metody** (`CUSTOM`) pro platby na místě a offline. * **Online metody**: karta, Apple Pay a Google Pay přes Stripe; karta, Apple Pay a Google Pay přes Adyen. MobilePay a Pay by Bank jsou metody Stripe zapnuté jen pro vybrané obchodníky. Jak platba postupuje, prochází fázemi autorizace, strhnutí a vrácení peněz. Každá platba nese jemnější stav – nevyřízená, úspěšná, částečně vrácena, vrácena, vrácení zrušeno, stornována nebo vypršela. **Čip platby** na objednávce vše shrnuje do binárního **Zaplaceno / Nezaplaceno** (`paymentStatus`: `PAID` / `UNPAID`). ### Vizualizace hierarchie ```mermaid theme={null} %%{init: {'flowchart': {'nodeSpacing': 30, 'rankSpacing': 40}}}%% flowchart TB Order["Objednávka
Kontejner"] LineItem1["Řádková položka 1
Produkt A"] LineItem2["Řádková položka 2
Produkt B"] Checkout["Pokladna
Připraveno k platbě"] Payment1["Platba 1
Vytváří daňový doklad"] Payment2["Platba 2
Částečná platba"] Trans1["Transakce 1
Platba kartou"] Trans2["Transakce 2
Platba hotovostí"] Trans3["Transakce 3
Původní strhnutí"] Trans4["Transakce 4
Částečné vrácení peněz"] Order -->|obsahuje| LineItem1 Order -->|obsahuje| LineItem2 Order <-->|"ruční: Objednávka vytváří pokladnu
online: Pokladna vytváří objednávku"| Checkout Checkout -->|odkazuje na| LineItem1 Checkout -->|odkazuje na| LineItem2 Checkout -->|může mít více| Payment1 Checkout -->|může mít více| Payment2 Payment1 -->|účtuje za| LineItem1 Payment1 -->|účtuje za| LineItem2 Payment1 -->|může obsahovat více| Trans1 Payment1 -->|může obsahovat více| Trans2 Payment2 -->|může obsahovat více| Trans3 Payment2 -->|může obsahovat více| Trans4 style Order fill:#3b82f633,stroke:#3b82f6,stroke-width:3px style LineItem1 fill:#fce7f3,stroke:#ec4899,stroke-width:2px style LineItem2 fill:#fce7f3,stroke:#ec4899,stroke-width:2px style Checkout fill:#d1fae5,stroke:#10b981,stroke-width:2px style Payment1 fill:#fef3c7,stroke:#f59e0b,stroke-width:2px style Payment2 fill:#fef3c7,stroke:#f59e0b,stroke-width:2px style Trans1 fill:#e0e7ff,stroke:#6366f1,stroke-width:1px style Trans2 fill:#e0e7ff,stroke:#6366f1,stroke-width:1px style Trans3 fill:#e0e7ff,stroke:#6366f1,stroke-width:1px style Trans4 fill:#e0e7ff,stroke:#6366f1,stroke-width:1px ``` ### Faktury Vedle plateb vystavuje TWICE **faktury** – zúčtovací dokumenty v modelu peněz. Řádek platby bez odkazu na fakturu jsou nezaúčtované peníze: jakmile prodej uspěje, TWICE z těchto řádků vyrazí fakturu a zpětně na ně otiskne id vyražené faktury. Řádek platby, který už na fakturu odkazuje, místo toho zúčtuje daný řádek faktury a nic nevyráží. `status` faktury sleduje jen životní cyklus dokumentu: `draft`, `open`, `cancelled`, `uncollectible` (ruční odpis) nebo `scheduled` (nadcházející cyklus předplatného, počítaný na vyžádání – nikdy neukládaný). Zaplacenost se odvozuje samostatně z `capturedTotal` a `refundedTotal` faktury a zrcadlí slovník plateb: nezaplaceno, částečně zaplaceno, zaplaceno, částečně vráceno, vráceno. Výnos z předplatného pochází z řádků faktury: každý fakturační cyklus přidá řádek nesoucí id předplatného a fakturační období, takže jedna faktura může fakturovat několik předplatných. Viz [Předplatná](https://www.twicecommerce.com/docs/cs/concepts/catalog/subscriptions.md). ## Vztahy * Platba vždy odkazuje na **řádkové položky**, za které účtuje – nikdy na celou objednávku v abstraktní rovině. * Platba vrácení peněz se zpětně propojuje s původní platbou přes `originalPaymentId`. Řádky vrácení interně vedou k původním řádkům platby (`originalPaymentLineId`); toto propojení na úrovni řádku není vystaveno v API. * Kauce je samostatný objekt platby na objednávce (s vlastními součty `authorised`, `captured`, `refunded` a `cancelled`), takže se pohyby kauce nikdy nemíchají s pohyby platby. * Platební poskytovatel (Adyen, Stripe, ruční) určuje, jaké metody jsou dostupné a zda je podporována autorizace/strhnutí. ## Životní cyklus ### Od objednávky k platbě **1. Objednávka vytvořena** Vytvoří se objednávka obsahující řádkové položky (Řádková položka představuje jeden konkrétní záznam produktu nebo služby v rámci objednávky a obsahuje příslušné skladové položky, množství, cenu a podrobnosti o vyřízení pro danou část transakce.). Objednávky lze vytvořit ručně v administraci nebo automaticky z online pokladny zákazníka. Více: [Životní cyklus objednávky](https://www.twicecommerce.com/docs/cs/concepts/orders/order-lifecycle.md) **2. Pokladna vytvořena** Pokladna se vytvoří buď z košíku na storefrontu – v takovém případě její dokončení vytvoří objednávku – nebo ručně z administrace proti již existující objednávce. Pokladna nemusí pokrývat celou objednávku. Odkaz na pokladnu nese vámi vybrané řádky, každý s vlastní částkou k vybrání, a zákazník vidí jen tyto řádky. Tato částka je strop: pokladna nikdy nenaúčtuje víc, než řádek v okamžiku platby ještě dluží. Více: [Objednávka - Platba](https://www.twicecommerce.com/docs/cs/orders/order-tabs/payment.md) **3. Platba (platby) vytvořena(y)** V rámci pokladny se vytvoří jedna nebo více plateb: * Každá platba odkazuje na konkrétní řádkové položky * Každá platba vytváří vlastní daňový doklad * Více plateb umožňuje scénáře částečné platby (kauce + doplatek, splátky) **4. Transakce zpracovány** Každá platba může obsahovat více transakcí – rozdělené platební metody, vrácení peněz atd. ### Autorizace a strhnutí U poskytovatelů, kteří to podporují (Adyen a Stripe u karet), používá TWICE dvoukrokový tok autorizace/strhnutí: ```mermaid theme={null} flowchart LR Order[Objednávka vytvořena] --> Checkout[Pokladna vytvořena] Checkout --> Auth[Platba autorizována] Auth --> Capture[Platba stržena] Capture --> Complete[Platba dokončena] Complete --> Refund[Transakce vrácení peněz] Complete --> Partial[Transakce částečného vrácení peněz] Auth --> Void[Autorizace zrušena] style Order fill:#3b82f633,stroke:#3b82f6,stroke-width:2px style Checkout fill:#10b98133,stroke:#10b981,stroke-width:2px style Complete fill:#fef3c7,stroke:#f59e0b,stroke-width:2px style Refund fill:#e0e7ff,stroke:#6366f1,stroke-width:2px style Partial fill:#e0e7ff,stroke:#6366f1,stroke-width:2px style Void fill:#ef444433,stroke:#ef4444,stroke-width:2px ``` * **Autorizace**: zablokuje prostředky na kartě, aniž by je strhla. Používá se u rentálních vyzvednutí, aby obchodník mohl upravit konečnou částku. * **Strhnutí**: vezme autorizované prostředky. Může jít o plné strhnutí, nebo částečné strhnutí za méně, než bylo autorizováno. * **Zrušení**: uvolní autorizaci bez strhnutí. Používá se, když je objednávka stornována před vyzvednutím. * **Vypršelo**: poskytovatel automaticky zrušil blokaci, protože nebyla strhnuta v okně autorizace (u Stripe typicky \~7 dní). ### Kauce Kauce jsou samostatný objekt platby vedle hlavní platby. Na objednávce se zobrazují jako vlastní blok s vlastními součty `authorised`, `captured`, `refunded` a `cancelled`. | Metoda kauce | Jak funguje | | :- | :- | | **Automatická (karta)** | Na kartu zákazníka se umístí dodatečná autorizace. Strhne se jen v případě potřeby (poškození, pozdní vrácení), jinak se zruší. Vyžaduje kartovou platební metodu – `CARD_STRIPE` nebo `CARD_ADYEN`. | | **Ruční** | Personál zaznamená, že kauce byla přijata mimo TWICE (hotovost, doklad totožnosti, bankovní převod). Uvolní se při vrácení nastavením ruční kauce zpět na nulu. | | **Bez kauce** | Většina jednorázových prodejních objednávek. | Dostupnost metody kauce je vázaná na platební metodu – `PAY_STORE` a vlastní ruční metody podporují ruční kauce, zatímco kartové metody podporují automatické kartové kauce. > [!NOTE] > > Ruční platební metody (platba při vyzvednutí, vlastní metody) jsou u pokladny povoleny, i když objednávka obsahuje kauci. V takovém případě se kauce zpracuje jako ruční kauce. Jen objednávky s automaticky stahovanými předplatnými vyžadují kartovou platební metodu – samotné kauce ne. > [!NOTE] > > Pokud kartová blokace kauce není strhnuta v okně autorizace poskytovatele (u Stripe typicky \~7 dní), poskytovatel ji automaticky zruší. Karta Platby ji zobrazuje jako **Vypršelo**, na rozdíl od ručního uvolnění, které se zobrazuje jako **Zrušeno**. Viz sekci Vypršení autorizace v [Kaucích](https://www.twicecommerce.com/docs/cs/concepts/orders/deposits.md). ### Částečná strhnutí a částečná vrácení peněz Strženou transakci lze částečně vrátit vícekrát, dokud není vrácena celá. Každé vrácení vytvoří nový záznam platby typu `refund` propojený s původní platbou přes `originalPaymentId`. Vrácení peněz může poskytovatel sám stáhnout zpět (`refund_reverse`) – například když bankovní vrácení selže a peníze se vrátí k vám – a nestržená autorizace, která vyprší, vytvoří záznam `expire`. Když vystavujete vrácení peněz: 1. Určíte **transakci**, která se má vrátit, a **celkovou částku**. 2. Volitelně určíte, které **řádky platby** se mají vrátit a kolik na každý. 3. TWICE vytvoří platbu vrácení a aktualizuje `modificationSummary` původní transakce. > **Po řádcích (explicitní)** > > Určete přesně, které řádky platby se mají vrátit a v jaké výši. Částky po řádcích musí dát dohromady celkovou vracenou částku. Nastavením částky řádku na `null` se vrátí celá zbývající vratitelná částka daného řádku. > > **Případ použití**: Vrácení jednoho produktu ve víceproduktové objednávce, aniž by se to dotklo ostatních. > **Proporcionálně (automaticky)** > > Řádky platby zcela vynechte. Vracená částka se rozdělí proporcionálně mezi všechny vratitelné řádky podle jejich zbývajících vratitelných částek. Zaokrouhlovací zbytek jde na nejvyšší řádek. > > **Případ použití**: Vystavení paušálního vrácení peněz jako gesta dobré vůle, rovnoměrně rozděleného. `modificationSummary` původní transakce sleduje dvanáct polí: | Pole | Popis | | :- | :- | | `capturedTotal` | Součet úspěšných strhnutí. | | `refundedTotal` | Hrubý součet úspěšných vrácení peněz. **Není** čistý proti stažením zpět – před výpočtem zbývajících vratitelných částek ho očistěte o `refundReversedTotal`. | | `refundReversedTotal` | Součet úspěšných stažení vrácení zpět – peníze z vrácení stržené zpět k vám. | | `cancelledTotal` | Součet zrušených (uvolněných) částek autorizace. | | `expiredTotal` | Částka autorizace, která vypršela nevyzvednutá. | | `pendingRefundsTotal` | Vrácení peněz zahájená, ale zatím nevypořádaná. | | `pendingCapturesTotal` | Strhnutí zahájená, ale zatím nevypořádaná. | | `isPartiallyRefunded` | `true`, když byla vrácena část (ale ne vše) z částky. | | `isFullyRefunded` | `true`, když byla vrácena celá stržená částka. | | `isCancelled` | `true`, když byla autorizace zrušena. | | `isReversed` | `true`, když bylo vrácení peněz na této transakci staženo zpět. | | `isExpired` | `true`, když autorizace vypršela. | > [!WARNING] > > `refundedTotal` je hrubý a nečistý. Stažené vrácení peněz vám vrátí peníze, takže skutečně vrácená částka je `refundedTotal - refundReversedTotal`. Čtení samotného `refundedTotal` vrácení nadhodnocuje. > [!WARNING] > > Vrácení peněz se zpracovávají přes původního platebního poskytovatele. Vrátit lze jen transakce se stavem `succeeded` a typem `capture`. ### Sesouhlasení > **Automatické párování** > > U integrovaných poskytovatelů TWICE automaticky spáruje transakce s platbami, propojí platby s pokladnami a objednávkami a aktualizuje stav platby objednávky, jak se transakce dokončují. > **Ruční sesouhlasení** > > U ručních plateb (hotovost, bankovní převod, platformy třetích stran) zaznamenejte platbu a transakci přímo. Použijte pole data platby, metody a externí reference, abyste je namapovali zpět na své účetnictví. > **Daňové doklady** > > Doklady se generují **za platbu**, ne za transakci. Jedna platba se dvěma transakcemi (dárková karta + hotovost) stále vytvoří jeden doklad pokrývající obě metody. ## Podporovaní poskytovatelé TWICE podporuje dva online platební poskytovatele a ruční tok pro vše ostatní. ### Online poskytovatelé | Poskytovatel | Metody | Opakované platby | Kauce | Poznámky | | :- | :- | :- | :- | :- | | **Stripe** | Karta (`CARD_STRIPE`), Apple Pay (`APPLE_PAY_STRIPE`), Google Pay (`GOOGLE_PAY_STRIPE`), MobilePay (`MOBILEPAY_STRIPE`), Pay by Bank (`PAY_BY_BANK_STRIPE`) | Ano (karta a peněženky) | Ano (automaticky přes autorizaci karty) | Připojeno přes Stripe Connect v **Nastavení → Platby → Stripe**. Apple Pay a Google Pay se aktivují automaticky, bez nutnosti přepínače. MobilePay a Pay by Bank jsou zapnuté jen pro vybrané obchodníky, takže jejich přepínače se dovtedy nezobrazují. `CARD_ONLINE_STRIPE` je starší alias pro `CARD_STRIPE`. | | **Adyen** | Karta (`CARD_ADYEN`), Apple Pay (`APPLE_PAY_ADYEN`), Google Pay (`GOOGLE_PAY_ADYEN`) | Ano (karta) | Ano (automaticky přes autorizaci karty) | Spravováno v **Nastavení → Platby**. Platí omezení podle země/měny za jednotlivé metody. | > [!NOTE] > > **Stripe** a **ruční/offline** platby jsou dostupné každému obchodu. **Adyen** je zapnutý jen pro vybrané obchodníky (stejně jako **SumUp** pro platby na terminálu na místě) – viz [Nastavení plateb](https://www.twicecommerce.com/docs/cs/settings/payments.md). ### Apple Pay a Google Pay Na Stripe se Apple Pay a Google Pay aktivují automaticky, jakmile připojíte Stripe a zapnete kartové platby. Neexistuje přepínač v administraci – peněženky se za běhu odvozují z kartové metody. TWICE registruje domény vašeho storefrontu (subdoménu i vlastní domény) u Stripe pro ověření domény Apple Pay. Registrace proběhne automaticky, když: * Připojíte svůj účet Stripe * Změníte subdoménu svého obchodu * Aktivujete vlastní doménu U pokladny Stripe vykreslí tlačítka peněženek podle zařízení a prohlížeče zákazníka. Apple Pay se zobrazuje v Safari a na zařízeních Apple; Google Pay v Chrome a na Androidu. Obě peněženky podporují opakované platby (předplatná) a kauce – Stripe ukládá podkladovou kartu jako znovupoužitelnou platební metodu. > [!NOTE] > > Apple Pay se nezobrazuje, je-li pokladna vložená v iframe. Google Pay toto omezení neovlivňuje. ### Ruční / offline platby Existují dvě ruční metody: * **Platba v prodejně** (`PAY_STORE`) – vestavěná metoda pro platbu vybranou při vyzvednutí. * **Vlastní metody** (`CUSTOM`) – metody, které si sami pojmenujete, každá s vlastním popiskem a volitelným popisem. Vytvořte jich, kolik potřebujete – „Bankovní převod", „Dárková karta", „Externí POS". Použijte je pro hotovost přijatou v prodejně, bankovní převody přijaté mimo TWICE, kartové terminály neintegrované přes Adyen/Stripe a obchodní kredit. Ruční platby stále vytváří daňový doklad, podporují vrácení peněz (zadané ručně) a agregují se do stavu platby objednávky stejně jako online platby. ## Časté dotazy > **Kdy se vytváří daňový doklad?** > > Na úrovni platby. Jedna platba = jeden doklad, bez ohledu na to, kolik transakcí danou platbu tvoří. Pokud zákazník zaplatí 120 € rozděleně mezi dárkovou kartu a hotovost v jedné platbě, doklad zobrazí 120 € s podrobným rozpisem obou metod. > **Proč jsou vrácení peněz samostatné platby místo záporných transakcí?** > > Vrácení peněz potřebují vlastní daňové doklady a auditní stopu. Vytvořením propojené platby vrácení (`originalPaymentId` → původní platba) TWICE zachová původní transakci neměnnou a přitom sleduje řetězec vrácení. > **Mohu strhnout méně, než bylo autorizováno?** > > Ano. Nastavte strhávanou částku nižší, než je autorizovaná částka; zbytek se uvolní – částečné strhnutí. > **Mohu autorizovat víc, než je celková částka objednávky, abych pokryl kauci?** > > Ne. Kauce používají samostatný objekt platby vedle hlavní platby, každý s vlastním životním cyklem autorizace/strhnutí. Díky tomu zůstává reporting a vracení peněz čisté. > **Kteří poskytovatelé podporují předplatná?** > > Kartové platby Stripe a Adyen. Apple Pay a Google Pay na Stripe také podporují předplatná – Stripe uloží podkladovou kartu pro opakované platby bez přítomnosti zákazníka. Metody s přesměrováním (MobilePay, Pay by Bank) a ruční metody jsou jen jednorázové. > **Jaký je rozdíl mezi stavem platby a čipem na objednávce?** > > Čip je souhrn. Za scénou má každá platba jemnější stav – nevyřízená, úspěšná, částečně vrácena, vrácena, vrácení zrušeno, stornována, vypršela; čip redukuje všechny platby na objednávce na binární **Zaplaceno / Nezaplaceno** (`paymentStatus`: `PAID` / `UNPAID`). ## Vývojářská reference Transakce jsou vázané na objednávky. Vrácení peněz a strhnutí žijí pod endpointy `payments`; konfigurace poskytovatele pod `paymentAccounts`. > **[API: Payments](https://www.twicecommerce.com/docs/api-reference/payments)** > > Otevřít endpoint v API referenci. ## Související články > **[Životní cyklus objednávky](https://www.twicecommerce.com/docs/cs/concepts/orders/order-lifecycle.md)** > > Status objednávky, platby a vyřízení. > **[Typy objednávek](https://www.twicecommerce.com/docs/cs/concepts/orders/order-types.md)** > > Jak typ nákupu utváří platební tok. > **[Integrace](https://www.twicecommerce.com/docs/cs/concepts/integrations/overview.md)** > > Připojení Stripe a správa platebních poskytovatelů. > **[Reporty](https://www.twicecommerce.com/docs/cs/reports.md)** > > Finanční reporty a sesouhlasení. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.