Wat zijn Application Callbacks in Post Affiliate Pro?
Ontdek hoe Application Callbacks werken in Post Affiliate Pro. Leer meer over aanpasbare gebeurtenistriggers voor verkopen, leads en affiliate-aanmeldingen met ...
8 min lezen
Beschikbaar in:
Post Affiliate Pro , Post Affiliate Pro Ultimate , Post Affiliate Network
Wat zijn Webhooks & Callbacks?
Webhooks (ook wel Application Callbacks of Postback URL’s genoemd) zijn geautomatiseerde HTTP-notificaties die Post Affiliate Pro naar externe systemen stuurt wanneer specifieke events plaatsvinden. In plaats van constant te pollen voor updates, ontvangen uw verbonden systemen directe notificaties op het moment dat er iets gebeurt in uw affiliateprogramma.
Deze functie is essentieel voor:
- CRM Integratie - Automatisch uw klantendatabase bijwerken wanneer verkopen plaatsvinden
- E-mail Automatisering - E-mailsequenties triggeren op basis van affiliate acties
- Boekhoudsystemen - Transactiedata synchroniseren met uw financiële software
- Aangepaste Dashboards - Real-time rapportage dashboards bouwen
- Third-Party Tracking - Externe tracking platforms notificeren van conversies
Types Webhooks
Post Affiliate Pro ondersteunt twee hoofdtypes webhooks:
Verkooptracking Webhooks
Deze webhooks worden getriggerd door transactie-gerelateerde events:
| Trigger Event | Beschrijving |
|---|---|
| On Create | Wordt geactiveerd direct wanneer een nieuwe transactie (verkoop, actie, lead) wordt geregistreerd |
| On Approve | Wordt geactiveerd wanneer een wachtende transactie wordt goedgekeurd |
| On Decline | Wordt geactiveerd wanneer een transactie wordt afgewezen |
| On Refund/Chargeback | Wordt geactiveerd wanneer een terugbetaling of chargeback wordt verwerkt |
U kunt een enkele webhook configureren om bij meerdere events te activeren, of aparte webhooks maken voor elk eventtype.
Affiliate Aanmelding Webhooks
Deze webhooks worden getriggerd door affiliate registratie events:
| Trigger Event | Beschrijving |
|---|---|
| On Register | Wordt geactiveerd direct wanneer een nieuwe affiliate het aanmeldformulier invult |
| On Approve | Wordt geactiveerd wanneer een wachtende affiliate wordt goedgekeurd door een merchant |
Verzoektypes
Post Affiliate Pro ondersteunt drie HTTP-verzoektypes voor webhooks:
GET Verzoek
Parameters worden toegevoegd aan de URL als query string parameters.
https://uw-systeem.com/webhook?transactionid=abc123&commission=50.00&orderid=ORD-456
POST Verzoek (Form-Urlencoded)
Parameters worden verzonden in de request body met standaard form encoding.
Content-Type: application/x-www-form-urlencoded
transactionid=abc123&commission=50.00&orderid=ORD-456
POST JSON Verzoek
Parameters worden verzonden als JSON-object in de request body.
Content-Type: application/json
{"transactionid": "abc123", "commission": "50.00", "orderid": "ORD-456"}
Beschikbare Variabelen voor Verkoop Webhooks
U kunt dynamische variabelen gebruiken in uw webhook URL’s die automatisch worden vervangen door actuele waarden. Gebruik het formaat ${#variabelenaam#} om een variabele op te nemen.
Transactie Data
| Variabele | Beschrijving |
|---|---|
${#transactionid#} | Unieke transactie identificatie |
${#visitorid#} | Bezoeker ID (tracking cookie) |
${#commission#} | Commissie bedrag |
${#totalcost#} | Totale orderwaarde |
${#fixedcost#} | Vast kosten bedrag |
${#orderid#} | Order ID van uw e-commerce systeem |
${#productid#} | Product ID |
${#dateinserted#} | Datum en tijd waarop de transactie werd aangemaakt |
${#dateapproved#} | Datum en tijd waarop de transactie werd goedgekeurd |
${#tier#} | Commissie tier niveau |
${#status#} | Transactie status (Approved, Pending, Declined) |
${#statuscode#} | Status code (A, P, D) |
${#type#} | Transactie type (Sale, Action, etc.) |
Campagne en Banner Data
| Variabele | Beschrijving |
|---|---|
${#campaignid#} | Campagne identificatie |
${#campaignname#} | Campagnenaam |
${#bannerid#} | Banner identificatie |
${#channel#} | Kanaalnaam |
${#channel_code#} | Kanaalcode |
${#coupon_code#} | Gebruikte couponcode |
Affiliate Data
| Variabele | Beschrijving |
|---|---|
${#userid#} | Affiliate gebruikers-ID |
${#refid#} | Affiliate referral ID |
Klik Data
| Variabele | Beschrijving |
|---|---|
${#firstclicktime#} | Eerste klik timestamp |
${#firstclickreferer#} | Eerste klik referrer URL |
${#firstclickip#} | Eerste klik IP-adres |
${#firstclickdata1#} | Eerste klik aangepaste data 1 |
${#firstclickdata2#} | Eerste klik aangepaste data 2 |
${#lastclicktime#} | Laatste klik timestamp |
${#lastclickreferer#} | Laatste klik referrer URL |
${#lastclickip#} | Laatste klik IP-adres |
${#lastclickdata1#} | Laatste klik aangepaste data 1 |
${#lastclickdata2#} | Laatste klik aangepaste data 2 |
Aangepaste Transactie Data
| Variabele | Beschrijving |
|---|---|
${#saledata1#} | Transactie aangepast dataveld 1 |
${#saledata2#} | Transactie aangepast dataveld 2 |
${#saledata3#} | Transactie aangepast dataveld 3 |
${#saledata4#} | Transactie aangepast dataveld 4 |
${#saledata5#} | Transactie aangepast dataveld 5 |
Geografische en Technische Data
| Variabele | Beschrijving |
|---|---|
${#ip#} | IP-adres van de klant |
${#countrycode#} | Landcode gebaseerd op IP |
${#refererurl#} | Referrer URL |
Valuta Data
| Variabele | Beschrijving |
|---|---|
${#originalcurrency#} | Originele valutanaam |
${#originalcurrencyvalue#} | Originele valutawaarde |
${#originalcurrencyrate#} | Gebruikte wisselkoers |
Notities
| Variabele | Beschrijving |
|---|---|
${#merchantnote#} | Notitie zichtbaar voor affiliate |
${#systemnote#} | Notitie alleen zichtbaar voor merchant |
${#actionName#} | Actie commissietype naam |
${#actionCode#} | Actie commissietype code |
Beschikbare Variabelen voor Aanmelding Webhooks
Voor affiliate aanmelding webhooks kunt u affiliate profiel variabelen gebruiken:
| Variabele | Beschrijving |
|---|---|
${#username#} | Affiliate e-mail/gebruikersnaam |
${#firstname#} | Affiliate voornaam |
${#lastname#} | Affiliate achternaam |
${#name#} | Volledige naam (voor + achternaam) |
${#userId#} | Affiliate gebruikers-ID |
| Aangepaste velden | Elk aangepast profielveld via zijn code |
Multi-Tier Ondersteuning
Standaard worden webhooks alleen uitgevoerd voor tier 1 (directe) commissies. U kunt de “Execute for each tier” optie inschakelen om webhooks te triggeren voor alle tier niveaus in multi-tier commissiestructuren.
Dit is nuttig wanneer:
- U commissies moet volgen op alle niveaus van uw affiliate hiërarchie
- Uw externe systeem moet weten over sub-affiliate verdiensten
- U uitgebreide rapportage bouwt die alle commissieniveaus bevat
Webhook Filtering Opties
U kunt webhooks configureren om specifieker te zijn:
Per Commissietype
Beperk de webhook tot een specifiek commissietype (bijv. alleen voor “Premium Sales” actie commissies).
Per Affiliate
Maak webhooks die alleen activeren voor een specifieke affiliate. Dit is nuttig voor:
- Affiliates die hun eigen tracking systemen gebruiken
- Speciale integraties voor top-presterende affiliates
- Webhooks testen met een enkele affiliate voordat u uitrolt
Per Account (Network Mode)
In Post Affiliate Network kunt u account-specifieke webhooks maken.
Webhook Log & Monitoring
Post Affiliate Pro onderhoudt een uitgebreid log van alle webhook uitvoeringen, toegankelijk in het merchant panel onder Tools > Callbacks Log.
Het log toont:
- Log ID - Unieke identificatie voor elke webhook uitvoering
- Callback ID - Welke webhook configuratie werd gebruikt
- Request URL - De volledige URL die werd aangeroepen (met variabelen vervangen)
- Date Created - Wanneer de webhook in de wachtrij werd geplaatst
- Last Retry - Wanneer de laatste uitvoeringspoging werd gedaan
- Retry Number - Hoe vaak het systeem probeerde uit te voeren
- Status - Pending, Sent of Error
- Error Message - Details als de webhook faalde
Automatische Retry
Als een webhook faalt (bijv. uw server is tijdelijk niet beschikbaar), zal Post Affiliate Pro het verzoek automatisch opnieuw proberen. Dit garandeert betrouwbare levering zelfs tijdens tijdelijke storingen.
Log Retentie
Webhook logs worden automatisch opgeschoond na een configureerbaar aantal dagen (standaard: 60 dagen). U kunt dit aanpassen in Configuratie > Functies > Application Callbacks.
Webhook Beheer
Goedkeuringsworkflow
Standaard vereisen webhooks gemaakt door affiliates merchant goedkeuring voordat ze actief worden. Merchants kunnen:
- Auto-goedkeuring inschakelen - Automatisch alle nieuwe webhooks goedkeuren
- Handmatig beoordelen - Elke webhook individueel goedkeuren of afwijzen
Status Beheer
Webhooks hebben drie mogelijke statussen:
- Approved - Actief en wordt uitgevoerd wanneer getriggerd
- Pending - Wacht op merchant goedkeuring
- Declined - Afgewezen en wordt niet uitgevoerd
Merchants kunnen webhook status op elk moment wijzigen vanuit het webhooks beheer scherm.
E-mail Notificaties
Post Affiliate Pro kan e-mail notificaties sturen voor webhook-gerelateerde events:
Merchant Notificaties
- Nieuwe webhook gemaakt door affiliate
Affiliate Notificaties (Optioneel)
- Webhook status gewijzigd (goedgekeurd/afgewezen)
- Webhook gewijzigd door merchant
- Webhook verwijderd door merchant
Deze notificaties kunnen worden in- of uitgeschakeld in Configuratie > E-mail Notificaties.
Voorbeeld Use Cases
1. CRM Integratie
Stuur nieuwe verkoop data naar uw CRM wanneer een transactie wordt goedgekeurd:
https://crm.voorbeeld.com/api/sales?customer_order=${#orderid#}&value=${#totalcost#}&affiliate=${#refid#}
2. Slack Notificatie
Notificeer uw team kanaal wanneer een nieuwe affiliate zich aanmeldt:
https://hooks.slack.com/services/xxx/yyy?text=Nieuwe+affiliate:+${#firstname#}+${#lastname#}
3. E-mail Platform Trigger
Voeg klanten toe aan een e-mailsequentie na aankoop:
POST https://email.voorbeeld.com/api/subscribers
Body: {"email": "${#saledata1#}", "purchase_value": "${#totalcost#}"}
4. Boekhoudsoftware Sync
Registreer commissie betalingen in uw boekhoudsysteem:
https://accounting.voorbeeld.com/webhook?affiliate_id=${#userid#}&commission=${#commission#}&order=${#orderid#}
Hoe een Webhook In te Stellen
- Log in op uw Merchant Panel
- Navigeer naar Configuratie > Functies
- Activeer de Application Callbacks functie
- Ga naar Campagnes > [Selecteer Campagne] > Callbacks of de globale callbacks beheerder
- Klik op Nieuwe Callback Toevoegen
- Configureer:
- Naam - Een beschrijvende naam voor de webhook
- Type - Sale Tracking of Affiliate Signup
- Uitvoering - Wanneer te triggeren (on create, approve, decline, refund)
- Verzoektype - GET, POST of POST JSON
- URL - Uw endpoint met variabelen
- Execute for each tier - Ja/Nee
- Sla de webhook op
Beveiligingsoverwegingen
- Gebruik HTTPS endpoints voor veilige dataoverdracht
- Overweeg een geheime parameter toe te voegen om de webhook bron te verifiëren
- Implementeer rate limiting op uw ontvangende endpoint
- Valideer inkomende data voordat u verwerkt
- Bewaar webhook logs voor audit doeleinden
Gerelateerde Functies
- S2S Tracking - Server-naar-server tracking voor nauwkeurige conversies
- API - Volledige programmatische toegang tot Post Affiliate Pro
- API v3 - Moderne RESTful API met OAuth 2.0
