Partnerský webhook

Partnerský webhook je HTTP oznámenie odoslané do iného systému pri výskyte udalosti súvisiacej s partnerským programom, napríklad konverzie, aktualizácie provízie alebo zmeny stavu výplaty. Pri súvisiacich integráciách možno použiť callback alebo postback. Podporované spúšťače a dátové údaje závisia od platformy.

Pojmy webhook, callback a postback

Tieto názvy sa na rôznych platformách prekrývajú. Webhook označuje HTTP oznámenie spúšťané udalosťou. Callback je širší pojem pre odpoveď alebo oznámenie určené inému systému. V partnerských integráciách sa postback často vzťahuje na konverznú udalosť doručenú serverom. Samotný smer neposkytuje univerzálne rozlíšenie.

Príklady udalostí a akcie prijímajúceho systému

Ide o koncepčné príklady, nie o prísľub, že každá platforma poskytuje tieto spúšťače. Pred návrhom prijímajúceho systému si overte skutočný katalóg udalostí a verziu dátových údajov.

Webhooky a pravidelné dopytovanie

Pri pravidelnom dopytovaní sa API v stanovených intervaloch pýta na zmeny. Webhooky odosielajú podporované udalosti hneď, ako nastanú. Webhooky môžu znížiť počet opakovaných požiadaviek na API, zatiaľ čo pravidelné dopytovanie alebo zosúladenie údajov môže pomôcť obnoviť chýbajúci stav. Spoľahlivá integrácia môže používať oba prístupy a nemala by predpokladať, že oznámenia sú úplné a doručené v správnom poradí.

Príklad duplicitného oznámenia

Po vypršaní časového limitu sa udalosť schválenia doručí dvakrát. Prijímajúci systém rozpozná rovnaké ID udalosti a zaznamená jednu zmenu stavu. Neskoršie vrátenie platby je iná udalosť, ktorú treba spracovať aj vtedy, ak sa týka tej istej transakcie.

Preto môže byť nesprávne odstraňovať duplicity každého webhooku iba podľa ID transakcie. Identita udalosti a identita transakcie slúžia na odlišné účely.

Prevádzkové kontroly

Neuvádzajte prihlasovacie údaje vo verejných príkladoch, zaznamenávajte výsledky doručenia bez zbytočných údajov o zákazníkoch a upozorňujte na opakované zlyhania. Prijímajúci systém by mal potvrdzovať požiadavky podľa zdokumentovaného protokolu odosielateľa a bezpečne spracovať finančné operácie. Dôležitý stav zosúlaďujte s autoritatívnou platformou; nespoliehajte sa iba na čas doručenia oznámenia.

Návrh prijímajúceho systému pre reálne podmienky doručovania

Overte, ktorá udalosť spúšťa oznámenie a či sa týka zaznamenanej, schválenej alebo vyplatenej provízie. Uložte identifikátor udalosti a príslušného objektu, overte požiadavku pomocou podporovaného spôsobu autentifikácie odosielateľa a úlohy, ktoré nemožno rýchlo dokončiť, zaraďte do frontu.

Počítajte s duplicitnými, oneskorenými, neúspešnými a nesprávne zoradenými udalosťami. Opakovaný pokus by mal aktualizovať ten istý záznam, nie vyplatiť bonus dvakrát. Ak schválenie príde skôr, než máte lokálny záznam o predaji, načítajte chýbajúci stav alebo zosúlaďte údaje namiesto toho, aby ste poradie doručenia považovali za obchodné pravidlo.

Oficiálna dokumentácia webhookov Stripe opisuje vzory doručovania a návrhu koncových bodov; podpisy a dátové údaje v nej sú špecifické pre Stripe. Informácie o skutočných poliach, podporovaných spúšťačoch a autentifikácii nájdete v dokumentácii danej partnerskej platformy. Pred prepojením webhooku s finančnou operáciou otestujte neúspešné odpovede a zosúladenie údajov.

Informácie o príslušných nastaveniach Post Affiliate Pro nájdete v dokumentácii k webhookom a callbackom . Konfiguráciu a požiadavky integrácie si overte podľa pravidiel svojho programu.

Prehľad procesu