Prerequisites

For Roku in-app purchases to be connected to Cleeng's system, the following steps must be completed:

  1. Create a Roku customer account

  2. Enroll as a Roku developer

  3. Register for Roku Partner Payouts Program

  4. Configure in-app products for your Roku channel app

🚧

Note: Each Roku Product ID should match its Cleeng Offer ID

Exception:
Please note that underscore(_) is not supported in Roku, so you have to replace it by dash (-)
Example,

Cleeng Offer IDRoku Product ID
S123123123_USS123123123-US
  1. Set your Roku push notification URL to this Cleeng endpoint:
  • https://cleeng.com/roku/push-notification/{publisherId} (production environment)
  • https://sandbox.cleeng.com/roku/push-notification/{publisherId} (sandbox environment)

Replace {publisherId} with your publisher ID in the URL.

Providing a URL is necessary to receive account activity notifications (e.g. purchases, subscription cancellations, reversals, etc.). To see which notifications are supported, please refer to the Notifications section below.

  1. Contact Cleeng to finalize Roku in-app purchase setup.

You need to deliver an API Key to our Broadcaster Success Specialists team to enable Roku functionality.

Purchase Flow

The Roku channel app is responsible for displaying the “buy" button to initiate the payment. Once successful payment is completed through Roku Billing, the Cleeng receipt endpoint must be notified. For details, see the /roku/payment endpoint.

Validate Access

Payment processing is an asynchronous process. Even that most responses are within 4 seconds, it can take up to 30 seconds.
Our recommendation is that the application polls the Cleeng API using the getAccessStatus() or getAccessibleTags() method until the transaction is completed and access is granted.

The below flowchart shows the process:

15501550

Roku user registration flow

Notifications

Push Notifications provide direct communication between Roku and Cleeng with near real-time subscription updates.

To receive notifications you need to provide a URL address as specified in the Prerequisites section.

The table below presents which Roku notifications are supported:

Roku Notification

Supported at Cleeng

Cancellation

Refund

Sale - Notifications used for a renewal process

UpgradeSale - Notifications used for subscription upgrade

DowngradeSale - Notifications used for subscription downgrade


Did this page help you?