Refersion
Datafly Signal posts completed orders to Refersion’s paid-order webhook, with the cart ID that your storefront gave Refersion’s JavaScript tracker at checkout, so each sale is credited to the referring affiliate.
Prerequisites
Get your API keys
In Refersion, open Account > Settings > Refersion API and copy the public and secret keys. Signal sends them as the Refersion-Public-Key and Refersion-Secret-Key headers.
Keep Refersion’s JavaScript tracker
Refersion attributes a webhook order through the cart ID its tracker recorded at checkout (r.sendCheckoutEvent()). Send the same value on the purchase event as properties.cart_id. Refersion asks for a value that is not sequential or guessable, such as a session ID.
Configure in Signal
Configuration Fields
| Field | Required | Description |
|---|---|---|
public_key | Yes | Your Refersion API public key. Find it in the Refersion dashboard under Account > Settings > Refersion API. |
secret_key | Yes | Your Refersion API secret key, paired with the public key. Found alongside the public key under Account > Settings > Refersion API. Stored encrypted. |
Management UI Setup
- Go to Integrations > Add Integration > Refersion.
- Choose a preset: Default (
default), Retail (ecommerce). - Fill in the fields above and click Save.
Request format
A purchase:
POST https://inbound-webhooks.refersion.com/tracker/orders/paid
{"cart_id":"cart-7f3e9a","currency_code":"GBP","customer":{"email":"jane.doe@example.com","first_name":"Jane","ip_address":"203.0.113.9","last_name":"Doe"},"discount_code":"SAVE10","items":[{"name":"Parka \u0026 Hood","price":120,"quantity":2,"sku":"SKU_1"},{"name":"Gloves","price":19.99,"quantity":1,"sku":"SKU_2"}],"order_id":"ORD-1001","shipping":10,"tax":43.33}Line items come from items[] (falling back to products[]), with the unit price and quantity.
Event Mapping
| Signal event | Vendor event | Presets |
|---|---|---|
purchase | order_paid | Default, Retail |
Identity
cart_id is the match key; orders without one are not sent. The customer’s email (trimmed and lower-cased), first and last name and IP address go in the JSON body’s customer object, unhashed by design: Refersion links the order’s email address to the referring affiliate for lifetime commission, which a hash cannot do (#1339). Nothing is sent in the URL.
Consent
Refersion documents no consent parameter. Affiliate conversions are not held back for marketing consent: the affiliate who referred the visitor is paid through them (product decision, #1219). Operators whose legal advice differs can set the pipeline’s affiliate_click_ids_require_consent, or assign a consent category to the integration.
Troubleshooting
| Problem | Solution |
|---|---|
| Orders not credited | Check the purchase event carries the same cart_id the Refersion tracker recorded at checkout. |
| 401 or 403 | The public or secret key is wrong. |
Blueprint
The Refersion blueprint version is 0.5.1. It was last reviewed against the vendor’s documentation on 2026-09-23.