subscriber-status-change

Fires whenever the status of a subscriber changes.

Using Socket.IO, this event can be listened to as follows:

JavaScript

socket.on('subscriber-benefits-change', function(data){
    //Do something
});

This event fires whenever the status of a subscriber changes. This change can be the result of a subscriber cancelling, a subscriber’s recurring payment failing, etc. The event response has the following JSON structure:

JSON

{
   event: "subscriber-status-change",
   channel_id: "channel identifier",
   channel: {
      names: {
         gamewisp: "GameWisp channel name",
         twitch: "twitch channel name",
         youtube: "youtube channel name"
      },
      ids: {
         gamewisp: "channel identifier",
         twitch: "12312312q",
         youtube: "UCiqp4J8asdkssssssssdfae"
      }  
   },
   data: {
      ids: {
         gamewisp: "123222",
         twitch: "95512221241604"
      },
      usernames: {
         gamewisp: "gamewisp_username",
         twitch: "twitch_username"
      },
      status: "trial",
      amount: "2.99",
      subscribed_at: "2015-12-31 18:44:07",
      end_of_access: "2016-01-30 18:44:07",
      tier: {
         id: "123",
         title: "Tier Title",
         level: "1",
         cost: "2.99",
         description: "Tier description.",
         published: true
      }
    }    
}

The response is similar to the subscriber-new event, but the status field will contain the newly updated subscriber status. This event is not necessarily followed by a subscriber-benefits-change event.