Each time a referral is generated, it is assigned a status. There are four possible values that can be assigned:
- pending - This is a referral that has been generated but is not yet confirmed
- unpaid - This is a confirmed referral that is waiting to be paid out to the affiliate
- rejected - This is a referral that was rejected
- paid - This is a referral that has been paid to the affiliate
All referrals begin with a status of pending and are then updated to one of the other three statuses when particular events occur. A pending referral means that it is waiting to be confirmed as valid. Referrals are confirmed when orders in the e-Commerce platform are completed.
A referral is marked as rejected when the corresponding order in the e-Commerce platform is refunded or deleted. In Affiliates > Settings > Misc, there is an option to automatically mark referrals as rejected when orders are refunded or deleted. If enabled, AffiliateWP will mark referrals as rejected for you. If disabled, or your e-Commerce platform is not fully supported, referrals will need to be rejected manually.
Referrals are marked as unpaid when the corresponding order or signup is completed in your e-Commerce or membership platform. Once marked as unpaid, the referral is considered "earned" and should be paid out to the affiliate.
Referrals receive a status of paid as soon as they have been paid to the affiliate. Once marked as paid, a referral is considered closed and no further status changes are applied to it.