Přejít na hlavní obsah

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.

Integrace Stripe v Macaly umožňuje přijímat jednorázové platby přímo ve vašem projektu. Testovací prostředí se vytvoří automaticky, takže můžete začít stavět a testovat platby bez Stripe účtu. Jakmile budete připraveni přijímat reálné platby, propojíte svůj Stripe účet a přepnete do live režimu.
Dostupné v plánech Pro a Enterprise

​
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.

Napsal/a jsem e-book a chci ho prodávat za 490 Kč. Vytvoř stránku,
kde lidé zaplatí a hned si ho stáhnou.
Agent vytvoří projekt s kompletním platebním tokem a na pozadí zajistí testovací prostředí Stripe. Platby můžete také přidat přímo ze záložky Platby v horní navigační liště. Testovat můžete ihned pomocí testovací karty zobrazené v záložce Platby:
PoleHodnota
Číslo karty4242 4242 4242 4242
ExpiraceJakékoli budoucí datum (např. 01/30)
CVCLibovolná 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ě.
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.

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

Při vytvoření testovacího prostředí Macaly vytvoří Stripe 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 Dashboardu. 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 live režim budete potřebovat sandbox převzít, ověřit své podnikání u Stripe a zadat live API klíče.
1

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.
2

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.
3

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é platby). Tento krok lze také přeskočit.
4

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.
5

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í.
Synchronizace stavu může trvat několik okamžiků. Pokud je tlačítko pro převzetí stále viditelné, obnovte stránku.

​
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 live API klíče s Macaly.
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.

​
Aktivace Stripe účtu

Než budete moci získat live 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.
1

Otevřete Stripe Dashboard

Přejděte na dashboard.stripe.com a přihlaste se k účtu, který jste použili při převzetí sandboxu.
2

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é.
3

Počkejte na ověření

Stripe zkontroluje vaše údaje a aktivuje váš účet. Obvykle je to okamžité, 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.
Během čekání na ověření Stripe účtu můžete pokračovat ve stavbě a testování projektu v testovacím režimu.

​
Zadání live API klíčů

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

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.
Tajný klíč poskytuje plný přístup k vašemu Stripe účtu. Nikdy ho nesdílejte ani nevkládejte do chatu.
2

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_).
3

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ě.
4

Publikujte projekt

Publikujte projekt, aby se změny nasadily. Live platby se zpracovávají pouze na publikovaném webu, ne v náhledu.

​
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ů

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.
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.
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.
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.
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.
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.
Nepřevzaté sandboxy expirují po 60 dnech. Otevřete záložku Platby a klikněte na Set up new 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.

​
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).
  • 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 Set up new 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.