Status codes

What each status from the conversion endpoint means – and what to do about it.

Every sale reported to Affilyflow gets a status. You see it in the response from the conversion endpoint ({ "status": "…" }) and in the live test under Setup in the store dashboard. Many statuses are perfectly normal – only some mean the setup needs fixing.

Recorded

Status	Meaning	What to do
`ok`	The sale is recorded and attributed to an affiliate – or to the store's test link, if it was a test purchase. It now awaits the store's approval.	Nothing.

Normal – not counted

Status	Meaning	What to do
`duplicate`	The same order number came again in the same program and wasn't counted twice – e.g. a reloaded receipt.	Nothing. If it happens on every sale, check that the order number isn't the same every time.
`expired`	The click is older than the program's cookie window. The window is locked on the click.	Nothing. When testing: open the test link again and buy right after.
`unknown`	The click ID doesn't exist – deleted, wrong or never recorded. HTTP 404.	Check that you send the click ID unchanged (`c_…`). When testing: open the test link again and buy in the same browser.
`blocked`	The store has blocked the affiliate, so the sale earned no commission.	Nothing.
`suspended`	The affiliate is suspended, so the sale earned no commission.	Nothing.
`store_inactive`	The store is set to inactive, so the sale earned no commission.	Write to info@affilyflow.com if it is a mistake.

Fix the setup

Status	Meaning	What to do
`store_mismatch`	The click belongs to a different store than the one the sale was reported for.	Check that `data-store` (or `store`) is your own store ID from Setup.
`invalid_value`	The amount was negative.	Send the goods amount after discount, excluding VAT and shipping, as a positive number.
`zero_value`	The program pays a fixed amount per sale, but the order was 0.	Check that the amount comes through. On the receipt: check the amount field.
`value_too_high`	The order was above the program's amount cap (50,000 in the settlement currency by default) and wasn't recorded.	Check that the amount wasn't sent in cents. If it is a real sale, write to info@affilyflow.com.
`unsupported_currency`	The currency couldn't be converted: the code isn't three letters, or there is no rate from the last 10 days.	Send an ISO 4217 code such as `DKK` or `EUR`. If the code is right, write to info@affilyflow.com.
`stale_lead_trigger`	A lead (an order number starting with `lead_`) was reported to a program that pays per sale.	Remove the lead code or `data-lead-url`, and use the sale code.
`program_inactive`	The program was paused when the sale came in.	Turn the program back on if the pause wasn't intended.
`not_joined`	Only for legacy links without a click ID: the affiliate hasn't joined the program.	Nothing – the affiliate needs to use a link from their dashboard.

Rejected under the rules

These sales are recorded but shown as rejected with the reason – without commission, fee or notifications.

Status	Meaning	What to do
`self_referral`	The buyer's email is the same as the affiliate's (terms §7). Requires the integration to send `buyer_hash`.	Nothing.
`rule_breach`	The click broke the program's rules – a coupon site, forbidden paid search or a channel the program doesn't allow. Only when Affilyflow enforces program rules.	Nothing. The store sees the breach under Rule breaches.

Endpoint errors

Status	HTTP	Meaning	What to do
`error`	400	Neither a click ID nor `aff` + `store` was included.	Send `afid`.
`error`	500	Recording failed. The sale may not be saved.	Try again with the same order number – a duplicate isn't counted twice.
`rate_limited`	429	Too many calls from the same IP address.	Wait a moment and try again.
`too_large`	413	The body was over 64 KB.	Send fewer item lines.

From the integrations

The Stripe webhook, the WooCommerce plugin and the Shopify app report sales too, and these statuses can appear in their events:

Status	Meaning
`no_affiliate`	The sale came without a click or affiliate – a normal sale.
`not_recurring`	A subscription renewal where the click didn't qualify for subscription commission.
`first_rejected`	A renewal of a subscription whose first sale was rejected – no commission.
`cap_reached`	The subscription has reached the number of payments that earn commission.
`test_mode`	Stripe in test mode isn't booked.
`unpaid`	The payment wasn't completed.
`unattributed`	Shopify: a purchase without a click ID while the store is testing. Only the time is stored, and it is never credited.

For Stripe, unknown and expired are common: a checkout without an affiliate has no click.

Missing something?

Write to us – we answer quickly, and the page gets fixed.

Contact support