Odesílání objednávek do služeb Zapier, Make a dalších aplikací pomocí webhooků

Webhook posílá události vašeho e-shopu do jiné aplikace ve chvíli, kdy nastanou. Přidejte jeden a každá zaplacená objednávka se může dostat do služby Zapier nebo Make a odtud do aplikací jako Google Sheets, Slack, váš seznam e-mailů, účetní program a tisíce dalších. Nepotřebujete žádný kód.

Přidání webhooku

1. V administraci webu klikněte na Integrace.
2. V části Automatizace zapněte Webhooky. Otevře se okno.

   

3. V poli Událost vyberte událost, do pole Adresa webhooku vložte adresu, kterou vám dala vaše aplikace, a klikněte na Přidat webhook.
4. Kliknutím na Odeslat test odešlete ukázkovou objednávku a potom klikněte na Hotovo.

   

Webhooky začnou fungovat hned po přidání. Nemusíte nic publikovat.

Propojení se službou Zapier

1. Ve službě Zapier vytvořte Zap. Jako spouštěč zvolte Webhooks by Zapier a potom Catch Hook.
2. Zkopírujte adresu URL webhooku, kterou vám Zapier ukáže.
3. V Payly přidejte webhook pro událost Objednávka zaplacena a vložte do něj tuto adresu URL.
4. Klikněte na Odeslat test. Vraťte se do služby Zapier a klikněte na Test trigger. Uvidíte ukázkovou objednávku, #9999 pro John Smith.
5. Přidejte akci, kterou chcete, například nový řádek v Google Sheets, a přiřaďte pole: Order Number, Order Total, Order Customer Email a další.
6. Publikujte Zap. Od teď ho spustí každá zaplacená objednávka.

Webhooks by Zapier patří mezi prémiové aplikace služby Zapier, takže vyžaduje placený tarif Zapier.

Propojení se službou Make

1. Ve službě Make vytvořte scénář. Přidejte Webhooks, potom Custom webhook a kliknutím na Add vytvořte nový webhook.
2. Zkopírujte adresu, kterou vám Make ukáže.
3. V Payly přidejte webhook s touto adresou a klikněte na Odeslat test. Make si ukázku přečte a pozná z ní pole.
4. Přidejte moduly, které chcete, přiřaďte pole a scénář zapněte.

Události

• Objednávka zaplacena: objednávka je zaplacena. Patří sem první platba předplatného, každé obnovení i objednávka, kterou ručně přidáte jako zaplacenou.
• Objednávka odeslána: označíte objednávku jako odeslanou. Když objednávku odesíláte po částech, odešle se událost za každou zásilku.
• Peníze za objednávku vráceny: peníze se vracejí zákazníkovi, ať vrácení provedete v Payly, nebo ve Stripe či PayPal. Odešle se i každé částečné vrácení.
• Předplatné zahájeno: první objednávka předplatného.
• Předplatné obnoveno: každá platba po té první.
• Předplatné ukončeno: předplatné je zrušeno nebo vyprší, a to v den jeho ukončení.

Co Payly posílá

Každá událost se posílá ve formátu JSON. Každá událost objednávky obsahuje:

• Číslo objednávky, například #1000, její stav a kdy byla zaplacena
• Mezisoučet, slevu a slevový kód, dopravu, daň, celkovou částku a vrácenou částku, včetně měny
• Název, SKU, množství, cenu a celkovou cenu řádku u každé položky
• Jméno, e-mail a telefon zákazníka a doručovací adresu
• Způsob platby, například Stripe nebo PayPal
• test_mode, které má hodnotu true u objednávky zadané v testovacím režimu

Odeslání přidávají přepravce a číslo zásilky. Vrácení peněz přidávají celkovou dosud vrácenou částku. Události předplatného přidávají plán, jeho cenu, jak často se účtuje a datum dalšího obnovení. Ukázka odeslaná tlačítkem Odeslat test obsahuje "test": true. Čísla karet zůstávají u Stripe a PayPal, takže nikdy nejsou ve webhooku.

Když webhook selže

Aplikace má na odpověď 5 sekund. Pokud neodpoví, nebo odpoví chybou, Payly provede až 7 dalších pokusů během zhruba čtyř a půl hodiny. Okno Webhooky u každého webhooku vypisuje poslední doručení, takže vidíte, co se stalo.

Pokud selžou všechny pokusy u tří událostí po sobě, webhook se pozastaví a obrazovka Integrace to oznámí. Zkontrolujte adresu a potom klikněte na Znovu zapnout.

Ověření, že webhook pochází z vašeho e-shopu

Zapier a Make to nepotřebují. Pokud vytváříte vlastní aplikaci, každý požadavek má hlavičku X-Payly-Hmac-Sha256: tělo požadavku podepsané pomocí HMAC-SHA256 s tajným podpisovým klíčem vašeho e-shopu, ve formátu base64. Klíč najdete v okně Webhooky. Ze surového těla požadavku vypočítejte stejný podpis a oba porovnejte.

Hlavička X-Payly-Webhook-Id zůstává stejná, když se doručení zkouší znovu, takže vaše aplikace může přeskočit to, které už zpracovala.