Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Listeners & Interfaces

ReferralHero Kotlin / Java SDK

ReferralHero provides various interfaces with its SDK that can be used to receive a callback upon successful execution, or in case of some error while executing the API.

You can use these callbacks to:

  • Track the execution of the API

  • Check if the API call is successful or not

  • Receive API response data or some other data depending on the API

  • Get error message in case the API call fails

RHReferralCallBackListener

Callback interface for when the AddSubscriber, UpdateSubscriber, and also use in other API finishes execution.

This interface is used to receive a callback while updating Subscriber detail and status.

There are 2 methods in this Listener like success and failure methods

fun onSuccessCallback(response: String?)
fun onFailureCallback(response: String?)

onSuccessCallback method call, when the API finishes execution With success if api execution finishes with exception it will call onFailureCallback.

Parameters

response – String check below response for reference

Subscriber Data Class Sample Response

{
    "status": "ok",
    "data": {
        "id": "sub_8645f85ac894",
        "name": "Test User 10",
        "email": "test10@gmail.com",
        "phone_number": "",
        "crypto_wallet_address": "",
        "crypto_wallet_provider": "",
        "extra_field": "",
        "extra_field_2": "",
        "option_field": "",
        "conversion_amount": 0,
        "code": "3ab0f674",
        "position": 10,
        "referred": false,
        "referred_by": {},
        "people_referred": 0,
        "promoted": false,
        "promoted_at": null,
        "verified": true,
        "verified_at": 1684403108,
        "points": 0,
        "risk_level": 0,
        "host": "https://app.referralhero.com/dashboard/lists/MFxxxxxxxxxx/analytics/traffic",
        "source": null,
        "device": null,
        "status":"",
        "referral_link": "https://app.referralhero.com/dashboard/lists/MFxxxxxxxxxx/analytics/traffic?mwr=3ab0f674",
        "created_at": 1684403108,
        "last_updated_at": 1684403108,
        "response": "subscriber_created"
    },
    "calls_left": null,
    "timestamp": 1684403108
}

RHMyReferralCallBackListener

Callback interface for when the Get My Referral API finishes execution.

This interface is used to receive a callback while retrieving my Referral details.

There are 2 methods in this Listener like success and failure methods

onMyReferralSuccessCallback method call, when the API finishes execution With success if api execution finishes with exception it will call onMyReferralFailureCallback.

Parameters

response– ApiResponse<ListSubscriberData> check below response for reference

Get My Referral Sample Response

RHLeaderboardReferralCallBackListener

Callback interface for when the Get My Referral API finishes execution.

This interface is used to receive a callback while retrieving my Referral details.

There are 2 methods in this Listener like success and failure methods

onLeaderboardReferralSuccessCallback method call, when the API finishes execution With success if api execution finishes with exception it will call onLeaderboard ReferralFailureCallback.

Parameters

response– ApiResponse<RankingDataContent> check below response for reference

Get Leaderboard Sample Response

RHRewardsCallBackListener

Callback interface for when the Get Rewards API finishes execution.

This interface is used to receive a callback while retrieving my Referral details.

There are 2 methods in this Listener like success and failure methods

onRewardsSuccessCallback method call, when the API finishes execution With success if api execution finishes with exception it will call onRewardsFailureCallback.

Parameters

response– ApiResponse<ListSubscriberData> check this response for reference

Get Rewards Sample Response

PreviousPublic ClassesNextFlutter SDK

Last updated

Was this helpful?