Postback Payout (S2S)
Last updated
Last updated
In order for users to redeem their accumulated rewarded plays, they must be disbursed. Each reward can only be claimed once.
To utilize server-to-server payout, you must establish an endpoint on your server. This endpoint will be requested by us to notify you of the user's rewards. Upon receiving the notification, it will be your responsibility to deliver it to the user.
We strongly advise implementing server-to-server payout for rewards, as it offers increased security and enhanced transparency on your part.
Please contact TyrAds team and send your endpoint URL
Your endpoint will be invoked via HTTP
request with GET
method. The parameters of the request are as follows:
Paramater | Data Type | Description |
---|---|---|
To verify the authenticity of incoming requests, kindly reach out to the TyrAds team. Upon request, we will provide you with the whitelist IP addresses, enabling you to confidently authenticate requests originating from our platform.
conversion_status
enum
The status of conversion. Enum: approved
, rejected
conversion_type
enum
The type of conversion: Enum: install
, event
, rewardedPlay
payout
decimal
The payout amount you earn from Tyrads in U.S. Dollars.
user_payout
decimal
The payout amount the user earns based on the currency conversion set.
timestamp
integer
The UNIX timestamp of the conversion
publisher_user_id
string
The unique user id of the publisher used to identify the user
conversion_id
integer
The unique conversion ID can be used for deduplication if the conversion_type
is install
or event
. This parameter shouldn't be used if conversion_type
is rewardedPlay
, as for rewarded play conversion, we will always send the conversion ID of the install
rewarded_play_id
string
The unique rewarded play conversion ID can be used for deduplication if conversion_type
is rewardedPlay
. This parameter shouldn't be used if the conversion_type is install
or event
postback_id
integer
The unique postback ID can be used for deduplication. Increment value for install
and event
type is different from rewardedPlay
type, the postback ID from rewardedPlay
type can be duplicated with the postback ID from install
and event
type
app_name
string
The name of the app
event_name
string
The name of the event
sub3
string
The sub3 value, this can be any value you want and can be used to send to us on the click.
sub4
string
The sub4 value, this can be any value you want and can be used to send to us on the click.
ad_unit_id
string
The unique ad unit identifier