Background
⌘K

Postback URLs

Get real-time GET notifications when referrals, sales, or commissions happen.

Silvestro
Written by Silvestro
Last updated on March 5, 2026

Postback URLs send a GET request to your URL when events happen — perfect for ad networks, trackers, or automations.

Quick Setup

  1. Go to Settings → Postback in your affiliate portal
  2. Click Add Postback URL
  3. Pick your events, enter your URL with placeholders, save

Events

EventFires when…
referral.leadNew referral tracked
referral.convertedReferral becomes a customer
sale.createdPayment recorded
commission.createdCommission calculated

Placeholders

Insert these into your URL — they get replaced with real values:

PlaceholderExample
{event_type}commission.created
{referral_id}ref_abc123
{tracking_id}john
{affiliate_id}aff_xyz789
{status}CONVERTED
{sale_amount}99.00
{sale_currency}USD
{commission_amount}12.50
{commission_currency}USD
{transaction_id}txn_123
{timestamp}2026-03-05T10:30:45Z

Example

Template:

https://tracker.com/pb?event={event_type}&rid={referral_id}&amount={commission_amount}

What gets sent:

https://tracker.com/pb?event=commission.created&rid=ref_abc123&amount=12.50

Testing

Click Send Test on any saved postback URL. You'll see the HTTP status code and response time instantly.

Limits

  • Max 5 postback URLs
  • HTTPS only
  • 10s timeout per request
  • Up to 3 delivery attempts with exponential backoff (5 s → 30 s)

Was this article helpful?

If you still need help, our support team is here for you.

Contact Support
bg

Ready to Scale Your SaaS?

Affonso is the easiest way to launch your own affiliate program. We take care of the technical stuff, so you can focus on growing your business.