The Netflix bundle program allows your customers to purchase an offer which includes Netflix through your standard sales channels. Once purchased, customers can link a new or existing Netflix account to your bundle offer through the Web or Set-Top Box activation channels.
A reference for this transaction that can be used to track or reconcile this transaction, if needed in the future. Do not use a PAI value. Maximum size is 1024 bytes.
Describes your bundle offers. Each of your commercial bundle offers/plans should correspond to a unique BundleID. The BundleID is generated by Netflix. You are expected to pass it in the Update API when your customer changes from one bundle to another.
The primary email address preferred by the customer. Value has to be in standard email format. - Netflix will only update the email address for the bundle enrollment if the customer has not yet activated their bundle. - Do not pass dummy email addresses for any customer. If you do not have the customer’s primary or preferred email address, do not pass any email address.
A pre-agreed upon UUID for each of the Netflix plans (Basic, Standard, Premium, and other Netflix plans) available in your bundle offers. This is the actual offer for which the customer will be enrolled. It must not have a value less than the Base Plan value for the associated BundleId. Note: A NetflixOfferID corresponds to one (1) Netflix streaming plan (e.g., 1S - Basic, 2S - Standard, 4S - Premium). For each NetflixOfferID, Netflix generates a Sandbox (for testing) and Production version.
The language in which the customer prefers to be contacted by email or SMS. - Netflix will continue adding newer languages as and when they start supporting them. - If the PreferredLanguages is not present or does not match the Netflix defined standard, then the language associated with the PartnerChargeCountry will be used by default.
A reference for this transaction that can be used to track or reconcile this transaction, if needed in the future. Do not use a PAI value. Maximum size is 1024 bytes.
Describes your bundle offers. Each of your commercial bundle offers/plans should correspond to a unique BundleID. The BundleID is generated by Netflix. You are expected to pass it in the Update API when your customer changes from one bundle to another.
The primary email address preferred by the customer. Value has to be in standard email format. - Netflix will only update the email address for the bundle enrollment if the customer has not yet activated their bundle. - Do not pass dummy email addresses for any customer. If you do not have the customer’s primary or preferred email address, do not pass any email address.
A pre-agreed upon UUID for each of the Netflix plans (Basic, Standard, Premium, and other Netflix plans) available in your bundle offers. This is the actual offer for which the customer will be enrolled. It must not have a value less than the Base Plan value for the associated BundleId. Note: A NetflixOfferID corresponds to one (1) Netflix streaming plan (e.g., 1S - Basic, 2S - Standard, 4S - Premium). For each NetflixOfferID, Netflix generates a Sandbox (for testing) and Production version.
The language in which the customer prefers to be contacted by email or SMS. - Netflix will continue adding newer languages as and when they start supporting them. - If the PreferredLanguages is not present or does not match the Netflix defined standard, then the language associated with the PartnerChargeCountry will be used by default.
A reference for this change/transaction that can be used to track/reconcile with the trigger for this event, if any is needed in future. Max 1024 is bytes.
If a token is invalid, the customer cannot complete the bundle activation. In that case, Netflix will present a call to action where Netflix can redirect the user. You should provide the URL that corresponds with the correct page on your site where the user can restart the flow.
For ACCOUNT_RECOVERY token type only. This value can be up to 24 hours. The token expiration defaults to 12 hours if not provided. Please initiate the Token request once the customer has clicked on the call to action on your website and before you redirect the customer to Netflix.
Provide events concerning the account lifecycle of Netflix members
The API provides 'At least once' delivery semantics i.e. duplicate events may be returned across pages/dates.
GET/tv/netflix/orgs/{org_id}/subscriptions/events
Parameters
Name
In
Type
Required
Description
org_id
path
string
true
Tenant
startTimestamp
query
integer(int64)
true
A timestamp (specified in UNIX epoch seconds) to filter the events that have occurred on or after a specific time. Value must be within 14 days of the current time.
endTimestamp
query
integer(int64)
true
A timestamp (specified in UNIX epoch seconds) to filter the events that have occurred before a specific time. Value must be greater than startTimestamp and at least 15 minutes before the current time.
offset
query
integer(int64)
false
Used when retrieving subsequent pages of events that have occurred during the time period defined by startTimestamp and endTimestamp. Must be set to the value provided for the next_page_offset field of the previous response for the same time period. Do not build any logic or validation around this value.
events
query
array[string]
false
A case-sensitive comma-separated list of event types. The values must match the SubscriptionEventType values. Used to retrieve events of specific type(s) that have occurred during the time period defined by startTimestamp and endTimestamp. If this parameter is not provided, it defaults to returning all types of events.
Request example
1
2
3
4
curl -X GET https://provision-master.private.dev.k8s.masmovil.com/v1/tv/netflix/orgs/masmovil/subscriptions/events?startTimestamp='1683710542'&endTimestamp='1683796942'&offset='10'&events='BUNDLE_ACTIVATION,BUNDLE_PLAN_CHANGE'?startTimestamp=1683710542&endTimestamp=1683796942\
-H "Accept: application/json"