Affiliatewebhook

Een affiliatewebhook is een HTTP-melding die naar een ander systeem wordt gestuurd wanneer zich een affiliategerelateerde gebeurtenis voordoet, zoals een conversie, een commissiewijziging of een wijziging in de uitbetalingsstatus. Voor gerelateerde integraties kan een callback of postback worden gebruikt. De ondersteunde triggers en payloads zijn afhankelijk van het platform.

Terminologie voor webhooks, callbacks en postbacks

Deze benamingen overlappen elkaar op verschillende platforms. Een webhook is een gebeurtenisgestuurde HTTP-melding. Callback is een bredere term voor een antwoord of melding aan een ander systeem. In affiliate-integraties verwijst postback vaak naar een servergestuurd conversie-event. Alleen de richting bepaalt geen universeel onderscheid.

Voorbeelden van events en acties van de ontvanger

Dit zijn conceptuele voorbeelden, geen garantie dat elk platform deze triggers beschikbaar stelt. Controleer de daadwerkelijke eventcatalogus en payloadversie voordat je de ontvanger ontwerpt.

Webhooks versus polling

Bij polling vraagt een API volgens een schema om wijzigingen. Webhooks sturen ondersteunde events zodra ze plaatsvinden. Webhooks kunnen herhaalde API-aanvragen verminderen, terwijl polling of reconciliatie kan helpen om ontbrekende statusinformatie te herstellen. Een robuuste integratie kan beide gebruiken, in plaats van ervan uit te gaan dat meldingen volledig en op volgorde zijn.

Voorbeeld van een dubbele melding

Na een time-out wordt een goedkeurings-event tweemaal afgeleverd. De ontvanger herkent dezelfde event-ID en registreert één statusovergang. Een latere terugbetaling is een ander event dat nog steeds moet worden verwerkt, ook al heeft het betrekking op dezelfde transactie.

Daarom kan het verkeerd zijn om elke webhook uitsluitend op basis van de transactie-ID te dedupliceren. Eventidentiteit en transactie-identiteit hebben verschillende doelen.

Operationele controles

Neem in openbare voorbeelden geen inloggegevens op, registreer bezorgresultaten zonder onnodige klantgegevens en stel meldingen in voor herhaalde fouten. Een ontvanger moet verzoeken bevestigen volgens het gedocumenteerde protocol van de verzender en financiële gevolgen veilig verwerken. Reconcileer belangrijke statusinformatie met het gezaghebbende platform in plaats van alleen te vertrouwen op het moment waarop een melding binnenkomt.

Een ontvanger ontwerpen voor reële bezorgomstandigheden

Bevestig welke gebeurtenis de melding start en of deze betrekking heeft op een geregistreerde, goedgekeurde of uitbetaalde commissie. Sla de eventidentificatie en de relevante entiteitsidentificatie op, valideer het verzoek met de door de verzender ondersteunde authenticatiemethode en plaats werk dat niet snel kan worden afgerond in een wachtrij.

Houd rekening met dubbele, vertraagde, mislukte en buiten de juiste volgorde aangekomen events. Een nieuwe poging moet hetzelfde record bijwerken en niet tweemaal een bonus uitbetalen. Als een goedkeuring binnenkomt voordat je lokale verkooprecord bestaat, haal dan de ontbrekende status op of reconcileer deze in plaats van de volgorde van aankomst als bedrijfsregel te behandelen.

De officiële webhookdocumentatie van Stripe beschrijft patronen voor aflevering en het ontwerpen van endpoints; de handtekeningen en payloads zijn specifiek voor Stripe. Gebruik de eigen documentatie van het affiliateplatform voor de daadwerkelijke velden, ondersteunde triggers en authenticatie. Test mislukte antwoorden en reconciliatie voordat je een webhook koppelt aan een financiële actie.

Raadpleeg voor de bijbehorende instellingen van Post Affiliate Pro de documentatie over webhooks en callbacks . Controleer de configuratie en integratievereisten aan de hand van de regels van je programma.

Proces in één oogopslag