Skip to main content
Connect your Affonso affiliate program to sync affiliates into Sequenzy as subscribers and trigger email automations across the whole affiliate lifecycle: signups, referrals, commissions, coupons, and payouts.

​
What is Affonso?

Affonso is an affiliate marketing platform for SaaS companies. It tracks referral links, conversions, commissions, and payouts for your affiliate program.

​
Connecting Affonso

​
Step 1: Get Your Webhook URL

  1. Go to Settings → Integrations in Sequenzy
  2. Find Affonso under Affiliate Marketing
  3. Click Connect
  4. Copy the Webhook URL shown

​
Step 2: Create an Affonso API Key

  1. Open Connect → API in Affonso
  2. Click Create Key
  3. Grant the key Affiliates: read, Referrals: read, and Commissions: read permissions
  4. Copy the API key (it is shown only once)
Sequenzy stores the key encrypted and uses it to backfill affiliates that existed before you connected the integration, including their current performance totals.

​
Step 3: Create a Webhook Endpoint in Affonso

  1. Go to your Affonso dashboard
  2. Navigate to Settings → Webhooks
  3. Click Add Endpoint and paste your Sequenzy webhook URL
  4. Select All events (recommended), or pick the affiliate, referral, transaction, coupon, and payout events you need
  5. Copy the Signing Secret (it is shown only once)

​
Step 4: Complete the Connection in Sequenzy

  1. Return to Sequenzy’s Affonso connection modal
  2. Paste the API Key and Signing Secret
  3. Click Connect Affonso
That’s it! Sequenzy queues an initial import of your existing affiliates, then keeps them current from Affonso events. Every webhook is verified against the signing secret before it is processed.

​
What Gets Synced

During the initial backfill and whenever an affiliate signs up or is updated in Affonso, Sequenzy creates or updates a subscriber with the affiliate’s email, name, and these attributes. Attribute names are provider-agnostic (affiliate*, not affonso*), so your segments and automations keep working if you ever switch affiliate platforms: The initial sync imports Affonso’s absolute performance totals. Relevant referral, transaction, and payout webhooks update the subscriber immediately, then queue an absolute refresh so retries, refunds, deletions, and missed events cannot leave the totals drifting: Failed and refunded sales are not counted, and the universal transaction.updated event never double counts totals.
Referral, transaction, coupon, and payout events identify the affiliate by their Affonso affiliate id. The affiliate must already be synced (via an affiliate.created, affiliate.confirmed, or affiliate.updated webhook) before these events can be matched. The initial API backfill creates those subscriber profiles for affiliates who predate the connection; unmatched events are acknowledged and skipped.
The initial backfill sets current profile and performance attributes. It does not replay old affiliate.* events or enroll subscribers into sequences.

​
Event Naming

Events live in the provider-agnostic affiliate.* namespace and target the affiliate’s subscriber profile. Affiliate lifecycle events keep Affonso’s names; referral, transaction, coupon, and payout events are folded into the same namespace:

​
Using with Automations

​
Affiliate Welcome Sequence

  1. Go to Automations → Create New
  2. Set trigger to Event Received → affiliate.created
  3. Send a welcome email with their tracking link: Your referral code is {{affiliateTrackingId}}

​
Celebrate Conversions

Send affiliates a congratulations email whenever they refer a paying customer:

​
Payout Notifications

Trigger on affiliate.payout_paid to confirm payouts, using {{event.amount}} and {{event.invoiceNumber}} in the email body.

​
Reward Top Affiliates

Create a segment where affiliateTotalReferredRevenue is greater than 1000 and send them an upgraded commission offer or exclusive coupon.

​
Event Properties as Variables

Each event exposes its details as {{event.*}} variables in automation emails:
  • Referrals: referralId, trackingId, referralStatus, referredEmail, customerId, referrer
  • Transactions: transactionId, saleAmount, saleCurrency, saleStatus, commissionAmount, commissionStatus, incentiveType
  • Payouts: payoutId, amount, status, invoiceNumber, paidAt
  • Coupons: couponId, code, paymentProvider

​
Troubleshooting

​
Events Not Appearing

  1. Verify the webhook URL in Affonso matches the URL shown in Sequenzy
  2. Check that the signing secret you pasted matches the endpoint’s secret in Affonso
  3. Use the Activity button on the Affonso integration row to inspect recent webhook deliveries and errors

​
Referral or Payout Events Being Skipped

These events are matched through the affiliateId attribute. Check the Affonso integration row to confirm the initial affiliate backfill completed. If it failed, reconnect with an active API key that has Affiliates: read, Referrals: read, and Commissions: read permissions.

​
Signature Verification Failing

Affonso’s live service signs the exact raw request body with HMAC-SHA256 and sends it as sha256=<64-character hex digest> in X-Affonso-Signature. Affonso may instead send the Unix time in X-Affonso-Timestamp and a bare digest of <timestamp>.<raw body> in X-Affonso-Signature; Sequenzy accepts that format too, along with the older combined t=...,v1=... form. If your endpoint secret was rotated in Affonso, reconnect the integration in Sequenzy with the new signing secret.

​
FAQ

Yes. Affiliates are synced as regular subscribers so you can email them, segment them, and enroll them in sequences.
No. Referral events carry the referred customer’s email as an event property ({{event.referredEmail}}), but only the affiliate is created or updated as a subscriber. Referred customers usually enter Sequenzy through your normal signup or payment integrations.
No. The backfill creates or updates subscriber profiles without replaying historical events or enrolling those subscribers into sequences. New Affonso webhook events behave normally after the connection is active.
Their affiliateStatus attribute is set to DELETED and an affiliate.deleted event fires. The subscriber stays active so you keep history; build an automation on that event if you want to tag or unsubscribe them.
No. affiliateTotalReferredRevenue and affiliateTotalCommissionEarned are lifetime gross totals. Refunds emit affiliate.transaction_rejected events you can automate on, but totals are not decremented.
Yes, the Affonso integration is included at no extra cost.