PayPal

Pro napojení na platební bránu PayPal je potřeba mít aktivní PayPal účet s možností přijímat platby a získat klientské ID a heslo pro napojení přes API.

Registrace účtu

1. Otevřete si web PayPal a klikněte na tlačítko Sign Up (vpravo nahoře).
2. Hned v prvním kroku zvolte, že chcete vytvořit Business účet.
3. Následně vyplňte informace o vás a o vaší společnosti.
4. Vyplňte informace o bankovním účtu.

Jak získat ID a heslo pro napojení PayPal účtu

Přihlaste se na developer.paypal.com pomocí vašich Paypal přihlašovacích údajů.

Po přihlášení na stránce My Apps & Credentials přejděte na část REST API apps, přepněte na volbu Live klikněte na tlačítko Create App. Chcete-li, můžete zkontrolovat, že váš PayPal účet podporuje přijímání plateb pomocí odkazu account eligibility.

Na stránce Create New App zdejte jméno aplikace (např. e-shop) a poté klikněte na Create App.

Na další stránce zkontrolujte, že na ní je správně uveden váš e-mail, dále uvidíte vaše klientské ID (Client ID) a pod ním odkaz pro zobrazení hesla (Secret – klikněte na odkaz „Show“). Tyto údaje jsou platné pro produkční režim. 

Pro propojení PayPal s e-shopem potřebujete znát vaše klienské ID a heslo pro testovací (Sandbox) i produkční režim.  Proto nyní přejděte v levém menu zpět na stránku My Apps & Credentials a založte aplikaci stejným způsobem i v Sandbox módu.

Údaje z polí Client ID a Secret z testovacího i produkčního režimu předejte svému projektovému manažerovi.

Přechod na PayPal Orders v2

V říjnu 2025 jsme dokončili novou integraci PayPal – PayPal Orders v2. Přechod na ni je zatím na dobrovolné bázi. Nová verze umožňuje vracení plateb z administrace e-shopu podobně jako jste zvyklí u plateb přes platební brány. Díky použitým technologiím také není v konfliktu s Google reCAPTCHA Enterprise (s původní verzí PayPal nelze Google reCAPTCHA Enterprise použít). Do budoucna bude nutné přejít, přijde okamžik, kdy bude ukončena podpora původní verze.

Jak postupovat

1. Kontaktujte zákaznickou podporu WPJ, která vám zpřístupní potřebný modul.
2. Nastavte správné údaje Client ID a Secret v Nastavení eshopu (nebo nastavení konkrétní mutace) > záložka Dopravy a platby > PayPal v2 platební brána. V tomto nastavení je také k dispozici adresa pro webhook, který lze nastavit na straně PayPal, vizte návod níže. 
3. Je potřeba založit si novou platbu a nastavit u ní správný typ PayPal v2 platební brána a následně způsoby doručení – kombinace s touto platbou.

Webhook

Webhook slouží pro notifikování e-shopu ze strany PayPal o různých událostech. Pro e-shop je důležité hlavně schválení platby uživatelem, takže web zpracovává pouze typ Checkout order approved. Tento webhook slouží k tomu, aby se e-shop dozvěděl o potvrzení platby, a to i v případě, že se uživatel nevrátí z PayPalu zpátky na e-shop.

V Nastavení eshopu > záložka Dopravy a platby > PayPal v2 platební brána se nachází položka Webhook URL.

Uvedenou Webhook URL je potřeba vložit do administrace PayPal. Na stránce Apps & Credentials vyberete vaši aplikaci, kliknutím na její název se otevře její nastavení.

Dále vyhledejte sekci Webhooks, kde je tlačítko pro přidání Webhook.

V zobrazeném dialogu vložíte URL adresu z nastavení eshopu. Dále je potřeba nastavit typ. Po rozbalení sekce Checkout vyberete pouze možnost Checkout order approved.

Časté otázky k přechodu z původní verze PayPal na Orders v2

Je potřeba založit novou App v rámci PayPalu?

Ne, nenarazili jsme na žádný problém s využitím původního Client ID a Secret. Pouze webhook je třeba založit podle návodu výše.