How do I record referral visits and purchases?
See what your site submits to Referhatch for referral visits and attributed purchases, including order references and retry handling.
How do I record referral visits and purchases?
Brands use Referhatch to record referral activity submitted by their site. Start by registering an affiliate so you have an affiliate ID or referral code.
Record a visit
Use Record a referral visit with the affiliate ID or referral code. Each call records a new visit.
You can supply a UTC event time. If you omit it, Referhatch uses the current time. The result includes the visit ID, affiliate ID, referral code and event time.
Record a purchase
Use Record an attributed purchase and submit:
- The affiliate ID or referral code.
- A unique order reference.
- The purchase amount in currency units.
- The purchase currency, which defaults to USD.
- An optional UTC event time.
Referhatch returns the recorded purchase with its calculated commission and saved commission rate.
Amounts can have up to two decimal places. JPY amounts use whole units. Supported currencies are USD, EUR, GBP, CAD, AUD and JPY.
What happens when I retry a purchase?
Order references are unique within your account. Reuse the same reference to retry the same purchase.
An identical retry returns the original purchase. Reusing the reference with a different amount, currency or affiliate returns a conflict.