Wallet payments
Přehled
Připojuje se k PayPal. Vaši zákazníci zaplatí fakturu nebo jakýkoli záznam s částkou svým účtem PayPal na stránce PayPal. Zákazník tam platbu schválí a vrátí se; Adminium pak peníze strhne (PayPal tomu říká capture) a jednou je zaznamená k záznamu. Pokud se zákazník nevrátí, strhne je místo toho webhook nebo vlastní kontrola Adminia, a platba, kterou PayPal pozdrží, se zobrazí jako zpracovávaná, s důvodem, který PayPal uvede. Prodávajícím je váš obchod: potřebuje vlastní firemní účet PayPal Business a peníze jdou od zákazníka přímo na tento účet. Adminium nedrží žádný platební účet, žádné vlastní přihlašovací údaje ani žádné peníze a nic nezpracovává; nic, co zákazník zadá na stránce PayPal, se na váš server nedostane. Nastavuje se ve Studiu → Platby, nejdřív v sandboxu: aplikace REST s ID klienta a tajným klíčem a webhook pro každý režim, pak testovací platba jako kupující v sandboxu, která do vašich tabulek nic nezapíše. Peníze se vracejí z panelu Platba u záznamu nebo z Aktivity a zaznamená se i vrácení provedené v dashboardu PayPal. Zpochybněná platba se sleduje, dokud PayPal spor nerozhodne; odpovídáte na něj v dashboardu PayPal. Nabízí jediný způsob platby, účet PayPal zákazníka, a přijímá 24 měn, které přijímá PayPal, přičemž HUF, JPY a TWD jen v celých jednotkách. Potřebuje Adminium 0.3.33 nebo novější na veřejné adrese https na portu 443, kam PayPal posílá webhooky.
K čemu se připojuje
Tenhle není vázaný na jednu aplikaci. Funguje přímo v Adminium a v každé aplikaci, která doplňky hostí.
Co mu připojení dovolí
Potřebuje aplikaci REST z vašeho vlastního účtu PayPal Business, jednou pro sandbox a jednou pro ostrý režim: její ID klienta, její tajný klíč a ID jejího webhooku. Tajný klíč otevírá celý účet PayPal – užší klíč PayPal nemá –, proto se všechny tři ukládají šifrovaně na vašem serveru, pro každý režim zvlášť, a žádná část doplňku se nikdy nedostane do prohlížeče. Podpis každého webhooku se ověřuje na vašem serveru pomocí ID webhooku. Platby se zapisují jen k řádkům tabulek, které zvolíte v části „Co lze zaplatit“. Jeho serverová část smí volat šest adres níže a nic jiného.
Adresy, na které smí jeho serverový kód sáhnout
- api-m.paypal.com
- api-m.sandbox.paypal.com
- www.paypal.com
- www.sandbox.paypal.com
- api.paypal.com
- api.sandbox.paypal.com
Tenhle seznam je celý seznam: volání na jinou adresu se odmítne a zaznamená.
Co je potřeba k připojení
Klíč k API
Co přidává
Kde se objeví 3
- V Adminium: jeho karta ve Studiu → Platby → Nastavení, s kontrolním seznamem Aplikace sandbox, Webhook sandbox, Odeslat testovací platbu, Ostrá aplikace, Ostrý webhook, Přišla první ostrá platba
- Na platební stránce záznamu: „Zaplatit přes PayPal“, které zákazníka pošle na stránku PayPal
- V panelu Platba u záznamu a v Aktivitě: platby, které přijal, s jejich vrácením peněz a spory
Tabulky, které přináší 0
Žádné — vlastní tabulky nepřináší.
Nastavení, která si zvolíte 3
- ID klienta
- Tajný klíč
- ID webhooku
Když ho vypnete
Odpojení odebere obrazovky doplňku. Nikdy nezahodí tabulky, které vytvořil, nesmaže soubory, které zapsal, ani neodstraní řádky, které přidal — všechno, co zapsal, zůstane ve vaší databázi. Přihlašovací údaje, které dostal, se přitom odvolají a smažou.
Co zůstane
Každá už zaznamenaná platba a každé vrácení peněz zůstávají: u svého záznamu, v Aktivitě a ve vaší vlastní tabulce plateb, pokud jste nějakou zvolili. Žádné vlastní tabulky nepřinesl. Ruční způsoby platby a ruční zaznamenání platby fungují jako dřív a váš účet PayPal i peníze na něm zůstávají nedotčené.
Co zmizí
„Odpojit“ na jeho kartě nabízí dvě cesty. Zastavit nové platby: žádná nová platba nezačne a Adminium si přihlašovací údaje ponechá, aby dokončilo čekající platby a mohlo vracet peníze. Odstranit klíče: přihlašovací údaje se z tohoto serveru smažou a Adminium už přes PayPal nedokončí žádnou platbu ani nevrátí peníze. Jejich odstraněním zde se u PayPal nezruší; pro jistotu vytvořte pro aplikaci nový tajný klíč ve vývojářském dashboardu PayPal.
K ukázce
Žádná ukázka na těchto stránkách doopravdy nevolá cizí službu. Každý doplněk s sebou nese náhradní přenos, který odpovídá z vestavěných dat, a ten je zapnutý hned od začátku. Skutečné přihlašovací údaje patří k vlastnímu hostingu a jsou popsané v souboru README daného doplňku.
Jak ho zapnout Žádné z dem na tomto webu ho neobsahuje. Ve svém vlastním Adminiu (0.3.33 nebo novějším) nainstalujte Wallet payments v Doplňcích, otevřete Studio → Platby a projděte kontrolní seznam na jeho kartě, nejdřív v sandboxu. Každá testovací platební stránka nabízí také ukázkovou službu, která nepotřebuje žádný účet, takže celý postup včetně vracení peněz si můžete vyzkoušet dřív, než cokoli připojíte.
Adminium není s touto společností nijak spojeno.