> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe

> Přijímejte platby ve svém Macaly projektu

Integrace Stripe v Macaly umožňuje přijímat jednorázové i opakované platby (předplatné) přímo ve vašem projektu. Testovací prostředí se vytvoří automaticky, takže můžete začít upravovat svůj projekt a testovat platby bez Stripe účtu. Jakmile budete připraveni přijímat reálné platby, propojíte svůj Stripe účet a přejdete do živého režimu.

<Callout icon="user">
  Dostupné v [**plánech Pro a Enterprise**](/cs/welcome/pricing)
</Callout>

## Přidání plateb do projektu

Popište agentovi v chatu, jaké platby potřebujete. Například:

```
Chci prodávat svou kosmetiku online. Potřebuji obchod s katalogem
a pokladnou, aby zákazníci mohli platit kartou.
```

```
Napsala jsem e-book a chci ho prodávat za 490 Kč. Vytvoř stránku,
kde lidé zaplatí a hned si ho můžou stáhnout.
```

```
Spouštím měsíční online kurz jógy za 599 Kč. Vytvoř landing page,
kde se členové můžou přihlásit a aktivovat předplatné.
```

Agent vytvoří projekt s kompletní uživatelskou cestou a na pozadí nastaví testovací prostředí Stripe.

Platby můžete přidat také přímo ze záložky **Platby** v horním menu v chatu.

Testovat můžete ihned pomocí testovací karty zobrazené v záložce Platby:

| Pole        | Hodnota                              |
| ----------- | ------------------------------------ |
| Číslo karty | 4242 4242 4242 4242                  |
| Expirace    | Jakékoli budoucí datum (např. 01/30) |
| CVC         | Libovolná 3 čísla (např. 111)        |
| PSČ         | Libovolná hodnota (např. 11000)      |

Přejděte do projektu, dokončete testovací nákup a ověřte, že platební proces funguje správně.

<Tip>
  Můžete také testovat chybové scénáře, například zamítnuté karty nebo neplatné platební údaje, pomocí speciálních testovacích karet Stripe. Kompletní seznam testovacích karet a chyb, které simulují, najdete v [dokumentaci Stripe](https://docs.stripe.com/testing#declined-payments).
</Tip>

## Aktivace bezpečného testovacího prostředí

Při vytvoření testovacího prostředí Macaly vytvoří Stripe tzv. sandbox. Sandbox funguje okamžitě a umožňuje testovat platby, ale není propojený s žádným Stripe účtem. Nepřevzaté sandboxy expirují po 60 dnech.

Převzetím sandbox propojíte se svým Stripe účtem. Po převzetí je sandbox váš a můžete ho spravovat přímo ve Stripe.

Sandbox můžete převzít dvěma způsoby: ze záložky **Platby** ve svém projektu, nebo přes e-mail, který vám Stripe pošle po vytvoření testovacího prostředí.

Převzetí je také prvním krokem k přijímání reálných plateb. Pro přechod na živý režim budete potřebovat sandbox převzít, ověřit údaje o svém podnikání u Stripe a vložit API klíče.

<iframe src="https://www.youtube.com/embed/SVcTB6UZlIc" />

<Steps>
  <Step title="Otevřete záložku Platby">
    Otevřete záložku **Platby** ve svém projektu. Pod textem "Aktivujte své bezpečné testovací prostředí" uvidíte tlačítko **Převzít Stripe sandbox**.
  </Step>

  <Step title="Klikněte na Převzít Stripe sandbox">
    Stripe se otevře v novém panelu se stránkou **Claim your sandbox**.

    Pokud máte existující Stripe účet, vyberte ho ze seznamu. V opačném případě klikněte na **+ Create new account** a vytvořte si nový účet zdarma.

    Klikněte na **Continue**.
  </Step>

  <Step title="Vyplňte údaje o podnikání">
    Stripe se zeptá na základní informace:

    1. **Název firmy a lokace.** Zadejte název firmy a vyberte zemi. Klikněte na **Continue**.
    2. **Web a popis podnikání.** Uveďte URL svého webu a krátký popis svých produktů nebo služeb. Tento krok lze přeskočit kliknutím na **Skip**.
    3. **Zamýšlené využití Stripe.** Vyberte typy plateb relevantní pro vaše podnikání (např. jednorázové nebo opakované platby). Tento krok lze také přeskočit.
  </Step>

  <Step title="Dokončete nastavení sandboxu">
    Na závěrečné obrazovce Stripe zobrazí souhrn dalších kroků: dokončit nastavení, přepnout na live režim a začít přijímat platby. Klikněte na **Go to sandbox**.
  </Step>

  <Step title="Vraťte se do Macaly">
    Přejděte zpět do Macaly. V záložce Platby by se nyní mělo zobrazovat **Platby jsou v testovacím režimu** oranžově, což potvrzuje úspěšné převzetí.

    <Info>
      Synchronizace stavu může trvat několik okamžiků. Pokud je tlačítko pro převzetí stále viditelné, obnovte stránku.
    </Info>
  </Step>
</Steps>

## Přepnutí na Live režim

Až budete připraveni přijímat skutečné platby, je třeba aktivovat svůj Stripe účet a propojit API klíče s Macaly.

<Warning>
  Za veškeré právní a daňové povinnosti spojené s platbami, které přijímáte prostřednictvím svého projektu, nesete odpovědnost vy. Pokud si nejste jisti svými povinnostmi, poraďte se s daňovým poradcem.
</Warning>

### Aktivace Stripe účtu

Než budete moci získat API klíče, Stripe vyžaduje ověření vašeho podnikání. Jedná se o standardní proces, který probíhá výhradně na straně Stripe.

<Steps>
  <Step title="Otevřete Stripe Dashboard">
    Přejděte na [dashboard.stripe.com](https://dashboard.stripe.com) a přihlaste se k účtu, který jste použili při převzetí sandboxu.
  </Step>

  <Step title="Dokončete průvodce nastavením">
    Stripe vás vyzve k dokončení nastavení účtu. Obvykle zahrnuje:

    * Údaje o podnikání (právní název, adresa, typ podnikání)
    * Ověření totožnosti
    * Bankovní účet nebo údaje pro příjem plateb

    Postupujte podle průvodce nastavením, dokud nebudou všechny kroky označeny jako dokončené.
  </Step>

  <Step title="Počkejte na ověření">
    Stripe zkontroluje vaše údaje a aktivuje váš účet. Obvykle je to hned, ale v závislosti na zemi a typu podnikání to může trvat až několik dní.

    Po ověření je váš účet aktivní a live API klíče se zpřístupní v Dashboardu.
  </Step>
</Steps>

<Info>
  Během čekání na ověření Stripe účtu můžete pokračovat ve stavbě a testování projektu v testovacím režimu.
</Info>

### Zadání live API klíčů

Jakmile je váš Stripe účet ověřen, zkopírujte API klíče do Macaly.

<Steps>
  <Step title="Zkopírujte klíče ze Stripe Dashboardu">
    Ve Stripe Dashboardu se API klíče zobrazují v kartě **API keys** na pravé straně domovské stránky. Najdete je také pod **Developers → API keys** ve spodní části postranního panelu.

    Uvidíte dva klíče:

    * **Publishable key** začíná na `pk_live_`.
    * **Secret key** začíná na `sk_live_`.

    Zkopírujte oba klíče.

    <Warning>
      Tajný klíč poskytuje plný přístup k vašemu Stripe účtu. Nikdy ho nesdílejte ani nevkládejte do chatu.
    </Warning>
  </Step>

  <Step title="Zadejte klíče v Macaly">
    V záložce **Platby** klikněte na **Přidat Stripe propojení**. Vložte každý klíč do odpovídajícího pole a klikněte na **Uložit API klíče**. Ujistěte se, že používáte live klíče (začínající na `pk_live_` a `sk_live_`), ne testovací klíče (`pk_test_` a `sk_test_`).
  </Step>

  <Step title="Přepněte na Live režim">
    Klikněte na **Přepnout na Live režim**. Macaly překonfiguruje váš projekt tak, aby využíval váš live Stripe účet. Stav se změní na **Platby jsou aktivní** zeleně.
  </Step>

  <Step title="Publikujte projekt">
    Publikujte projekt, aby se změny nasadily. Live platby se zpracovávají pouze na publikovaném webu, ne v náhledu.
  </Step>
</Steps>

## Správa integrace

Veškeré nastavení plateb je přístupné ze záložky **Platby**:

* **Otevřít Stripe** otevře Stripe Dashboard, kde můžete sledovat transakce, provádět vratky a kontrolovat výplaty.
* **Přepnout na Live režim / Přepnout na testovací režim** umožňuje kdykoli přepínat mezi prostředími bez zásahu do kódu projektu.
* **Spravovat Stripe propojení** umožňuje aktualizovat live API klíče po prvním nastavení.
* **Testovací platby** zobrazují údaje testovací karty jako referenci v testovacím režimu.

## Řešení problémů

<AccordionGroup>
  <Accordion title="Co je sandbox a čím se liší od mého Stripe účtu?">
    Sandbox je dočasné testovací prostředí, které Macaly vytvoří za vás. Má vlastní testovací API klíče a umožňuje simulovat platby bez použití skutečných peněz. **Není** to váš Stripe účet. Při převzetí sandboxu ho propojíte se svým skutečným Stripe účtem. Dokud sandbox nepřevezmete, je anonymní a po 60 dnech expiruje.
  </Accordion>

  <Accordion title="Testovací platby neprocházejí">
    Ujistěte se, že používáte číslo testovací karty **4242 4242 4242 4242** s jakýmkoli budoucím datem expirace, libovolným 3místným CVC a libovolným PSČ. Pokud problém přetrvává, zkontrolujte chat, zda neobsahuje podrobnosti o chybě, nebo požádejte agenta o diagnostiku platebního toku.
  </Accordion>

  <Accordion title="Jaký je rozdíl mezi testovacím a live režimem?">
    **Testovací režim** používá sandboxové prostředí s testovacími klíči. Všechny platby jsou simulované a žádné skutečné peníze se neúčtují. **Live režim** používá váš ověřený Stripe účet s live klíči. Skutečné peníze se strhávají a zasílají na váš bankovní účet. Mezi režimy můžete kdykoli přepínat v záložce Platby. Přepnutí režimu neovlivňuje kód vašeho projektu, mění se pouze aktivní Stripe klíče.
  </Accordion>

  <Accordion title="Ve Stripe Dashboardu nenacházím live API klíče">
    Převzetí sandboxu a ověření Stripe účtu jsou dva oddělené kroky. Převzetí propojí sandbox s vaším účtem, ale stále je třeba dokončit ověření podnikání na Stripe (totožnost, údaje o firmě, bankovní účet), než se live klíče vygenerují. Otevřete Stripe Dashboard a dokončete průvodce nastavením. Pokud vidíte pouze testovací klíče (začínající na `pk_test_` a `sk_test_`), váš účet ještě nebyl plně ověřen.
  </Accordion>

  <Accordion title="Macaly stále ukazuje testovací režim, i když jsem ověřil/a Stripe účet">
    Ověření Stripe účtu nepřepne Macaly do live režimu automaticky. Musíte ručně zadat live API klíče v záložce Platby a poté kliknout na **Přepnout na Live režim**. Macaly vás ponechá v testovacím režimu, dokud explicitně nepřepnete.
  </Accordion>

  <Accordion title="Live platby neprocházejí">
    Zkontrolujte tři věci v tomto pořadí:

    1. **Publikovali jste projekt?** Live platby se zpracovávají pouze na publikovaném webu, ne v náhledu.
    2. **Jsou klíče správné?** Ověřte, že jste zadali **Publishable key** (začínající na `pk_live_`) a **Secret key** (začínající na `sk_live_`). Pokud jste omylem vložili testovací klíče, klikněte na **Spravovat Stripe propojení** a aktualizujte je.
    3. **Je váš Stripe účet plně ověřen?** Otevřete Stripe Dashboard a zkontrolujte, zda v průvodci nastavením nejsou nedokončené kroky. Stripe může vyžadovat dodatečné dokumenty před zpracováním live plateb.
  </Accordion>

  <Accordion title="Co se stane, když sandbox expiruje?">
    Nepřevzaté sandboxy expirují po 60 dnech. Otevřete záložku Platby a klikněte na **Nastavit nový sandbox** pro vytvoření nového prostředí. Váš existující platební kód zůstane beze změny. Pokud jste již sandbox převzali a ověřili Stripe účet, bude třeba po vytvoření nového sandboxu znovu zadat live klíče.
  </Accordion>
</AccordionGroup>

## Dobré vědět

* **Poplatky Stripe.** Macaly neúčtuje za platby žádné dodatečné poplatky. Na každou transakci se vztahují standardní poplatky Stripe (viz [stripe.com/pricing](https://stripe.com/pricing)).
* **Expirace sandboxu.** Nepřevzaté testovací prostředí expiruje po 60 dnech. V takovém případě otevřete záložku Platby a klikněte na **Nastavit nový sandbox**.
* **Webhooky se spravují automaticky.** Macaly konfiguruje a udržuje veškeré webhook endpointy. Ve Stripe Dashboardu není třeba nic nastavovat ručně.
* **Testovací a live prostředí jsou izolované.** Testovací transakce se nezobrazují ve vašem live Stripe účtu a nejsou účtovány žádné skutečné poplatky.