Reporting referral conversions

For clients with an OAuth integration

When the user is finally redirected, after their journey, to whichever destination you configured in your integration, you need to follow the steps described in User authorization.

This will allow you to obtain the user's unique identifier, as described in User information retrieval. You need to store this ID so that you can report referral conversions back to us.

As soon as the user conversion happens (for example, the user made a deposit over a certain amount), make an API call to our referral reporting endpoint described below.

post
Report referral conversion

https://RESOURCE_DOMAIN/referrals/redeem
This endpoint returns HTTP 201 Created when successful.
Request
Response
Request
Body Parameters
user_id
required
string
The user ID (uid) you stored for this user
Response
201: Created
‚Äč

For clients without an OAuth integration

This method requires the least effort on the client's part, but requires Fractal's explicit permission to use.

As soon as the user conversion happens (for example, the user made a deposit over a certain amount), ensure the following tracking pixel is rendered on the user's browser.

<img src="https://resource.fractal.id/referrals/redeem_cookie" style="display:none" />