{"_id":"56ad235c693f0a0d0085f0c3","user":"56acd6caa040860d00ac94a2","project":"56acd71213ac890d001c3c7a","__v":4,"parentDoc":null,"category":{"_id":"56ad20660ab3c00d00ce3347","__v":11,"pages":["56ad21651c09150d00a183a0","56ad235c693f0a0d0085f0c3","56ad24afd21f1b0d00fd2f86","56ad2e5b1c09150d00a183a6","56ad305879011b0d00c32aaa","56ad30c81a7ee417009ced18","56ad31432a7860170013f711","56ad33b21a7ee417009ced1a","56ad34a0b9ac5517006b6962","56ad35503fc1020d009776e1","56e7266bdbc36117006a41ff"],"project":"56acd71213ac890d001c3c7a","version":"56acd71213ac890d001c3c7d","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-01-30T20:43:18.400Z","from_sync":false,"order":9,"slug":"singularity-real-time-events","title":"Singularity: Real-Time Events"},"githubsync":"","version":{"_id":"56acd71213ac890d001c3c7d","project":"56acd71213ac890d001c3c7a","__v":15,"createdAt":"2016-01-30T15:30:26.928Z","releaseDate":"2016-01-30T15:30:26.928Z","categories":["56acd71313ac890d001c3c7e","56acd8f113ac890d001c3c81","56acd8f95ac4060d0027865e","56acd93a13ac890d001c3c82","56ad20660ab3c00d00ce3347","56ad356a2a7860170013f714","56ad47eb0ab3c00d00ce334f","56afd523bc304a0d00ace1df","56b29a019621f20d00efb37e","56b657e11bc6970d009feee7","5845cc3c39950c1b002afe77","5845cde163c11b250037967e","5846efd45d064323007b17b4","588604da4674e32300efd160","588627882393d50f00f1322c"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-01-30T20:55:56.898Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"This Event Fires for All Channels Nightly at Approximately 12:00PM CST.\",\n  \"body\": \"GameWisp renews all the subscribers for a particular day at the same time for each channel. Therefore, it is not uncommon to receive multiple **subscriber-renewed **events in succession for channels as they are renewed.\"\n}\n[/block]\nUsing Socket.IO, this event can be listened to as follows:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"socket.on('subscriber-renewed', function(data){\\n    //Do something\\n});\",\n      \"language\": \"javascript\"\n    }\n  ]\n}\n[/block]\nThis event sends data that is very similar to the [subscriber-new](https://gamewisp.readme.io/docs/subscriber-new) event but is included as its own unique event for convenience. Additionally, the subscriber-renewed event sends an extra field \"resubscribe_alert_id\" that holds the id of the anniversary alert associated with the renewal event. Applications can use the forthcoming Resubscriber Resource, to request the alert by  its id. The **subscriber-renewed** event fires whenever a subscriber is successfully billed for another month on GameWisp.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n   event: \\\"subscriber-renewed\\\",\\n   channel_id: \\\"channel identifier \\\",\\n   channel: {\\n      names: {\\n         gamewisp: \\\"GameWisp channel name\\\",\\n         twitch: \\\"twitch channel name\\\",\\n         youtube: \\\"youtube channel name\\\"\\n      },\\n      ids: {\\n         gamewisp: \\\"channel identifier\\\",\\n         twitch: \\\"12312312q\\\",\\n         youtube: \\\"UCiqp4J8asdkssssssssdfae\\\"\\n      }  \\n   },\\n   data: {\\n      resubscribe_alert_id: 6,\\n      ids: {\\n         gamewisp: \\\"26356\\\",\\n         twitch: \\\"46984772\\\"\\n      },\\n      usernames: {\\n         gamewisp: \\\"user_name\\\",\\n         twitch: \\\"user_name_twitch\\\"\\n      },\\n      status: \\\"active\\\",\\n      amount: \\\"3.99\\\",\\n      subscribed_at: \\\"2015-12-30 00:00:00\\\",\\n      end_of_access: \\\"2016-01-30 23:59:00\\\",\\n      tier: {\\n         id: \\\"111111\\\",\\n         title: \\\"Tier Title\\\",\\n         level: \\\"1\\\",\\n         cost: \\\"3.99\\\",\\n         description: \\\"Tier description\\\",\\n         published: true\\n      }\\n   }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\nIt is important to keep in mind that GameWisp processes renewals each day for all the channels that are flagged for renewal on that day at approximately 12:00PM CST. Therefore, if your application supports multiple GameWisp channels, it is not uncommon to receive multiple **subscriber-renewed **events in succession for channels as they are renewed.","excerpt":"Fired whenever a subscriber is successfully renewed for another month","slug":"subscriber-renewed","type":"fn","title":"subscriber-renewed"}

subscriber-renewed

Fired whenever a subscriber is successfully renewed for another month

[block:callout] { "type": "warning", "title": "This Event Fires for All Channels Nightly at Approximately 12:00PM CST.", "body": "GameWisp renews all the subscribers for a particular day at the same time for each channel. Therefore, it is not uncommon to receive multiple **subscriber-renewed **events in succession for channels as they are renewed." } [/block] Using Socket.IO, this event can be listened to as follows: [block:code] { "codes": [ { "code": "socket.on('subscriber-renewed', function(data){\n //Do something\n});", "language": "javascript" } ] } [/block] This event sends data that is very similar to the [subscriber-new](https://gamewisp.readme.io/docs/subscriber-new) event but is included as its own unique event for convenience. Additionally, the subscriber-renewed event sends an extra field "resubscribe_alert_id" that holds the id of the anniversary alert associated with the renewal event. Applications can use the forthcoming Resubscriber Resource, to request the alert by its id. The **subscriber-renewed** event fires whenever a subscriber is successfully billed for another month on GameWisp. [block:code] { "codes": [ { "code": "{\n event: \"subscriber-renewed\",\n channel_id: \"channel identifier \",\n channel: {\n names: {\n gamewisp: \"GameWisp channel name\",\n twitch: \"twitch channel name\",\n youtube: \"youtube channel name\"\n },\n ids: {\n gamewisp: \"channel identifier\",\n twitch: \"12312312q\",\n youtube: \"UCiqp4J8asdkssssssssdfae\"\n } \n },\n data: {\n resubscribe_alert_id: 6,\n ids: {\n gamewisp: \"26356\",\n twitch: \"46984772\"\n },\n usernames: {\n gamewisp: \"user_name\",\n twitch: \"user_name_twitch\"\n },\n status: \"active\",\n amount: \"3.99\",\n subscribed_at: \"2015-12-30 00:00:00\",\n end_of_access: \"2016-01-30 23:59:00\",\n tier: {\n id: \"111111\",\n title: \"Tier Title\",\n level: \"1\",\n cost: \"3.99\",\n description: \"Tier description\",\n published: true\n }\n }\n}", "language": "json" } ] } [/block] It is important to keep in mind that GameWisp processes renewals each day for all the channels that are flagged for renewal on that day at approximately 12:00PM CST. Therefore, if your application supports multiple GameWisp channels, it is not uncommon to receive multiple **subscriber-renewed **events in succession for channels as they are renewed.