Integrating a Streamate White Label via RocketGate
I. Description
You can upsell to your white label by posting new users to our system and having existing users click on a specially-constructed link to log in to the whitelabel. Users with valid payment details in your database will then be able to visit guest chat and paid chat on the whitelabel using their existing account information.
| Note: We highly recommend that you validate your integration with Streamate and perform a complete test from start to finish (including running a bill on a live credit card). Contact Reseller Support (support@cambuilder.com) for more information. |
| Note: The oneclick auto-login will not work if you have not already posted the user to our system. |
II. Process Overview
- Send an HTTPS POST postback request using one of these options:
- Create a new user
- Set an existing user as fraud
- Updating a password
- Updating an email address
- Updating a credit card
- Checking for a duplicate email address
- Handle the postback response
- Generate one-click auto-login
- The user is logged in to their new or existing account (if necessary) and taken to the target page, as specified in the repage parameters.
III. Postback Request
- The postback is used to securely gather the necessary sensitive information to create and modify a user account on the live cam site.
-
This is a hidden server-to-server call; the user doesn't see anything. You will need to send an HTTPS POST to:
- https://oneclick.naiadsystems.com/legacy/oneclickpostback?provider=rocketgate
A. Create New User
- This will create a new user account in our system and will enable the user to automatically login through the oneclick URL.
| Name | Description | Type | Required | Example |
|---|---|---|---|---|
| action | The action that should be performed. | char(10) | Yes | join |
| custFirstName | The customer's first name. | char(100) | Yes | Tom |
| custLastName | The customer's last name. | char(100) | Yes | Jones |
| custAddress | The customer's street address. | char(100) | No | 123 Main St |
| custCity | The customer's city. | char(100) | No | Seattle |
| custState | The customer's state. | char(2) | No | WA |
| custZip | The customer's zip code. | char(50) | Yes | 98101 |
| custCountry | The customer's country. | char(2) | Yes | US |
| custIP | The customer's IP address | char(16) | Yes | 127.0.0.1 |
| custEmail | The customer's email address. | char(100) | Yes | foo@example.com |
| custPassword | The customer's password. | char(30) | Yes | foobar |
| custNick | An optional nickname for the user to use on the cam site. | char(32) | No | superman |
| referredCustomerID | The Rocketgate customer ID used to bill this customer. | char(100) | Yes | 65891358435 |
| referringMerchantID | The Rocketgate merchant ID that this customer bills on. | char(20) | Yes | 978546 |
| siteid | The Rocketgate site ID this customer bills on, if applicable. (This can be used to distinguish between MIDs, descriptors, etc.) | char(20) | No | 2 |
| cardHash | The Rocketgate card hash value used to bill this customer. | char(64) | Yes | QVImJyFEaUIWmIiZVgNBhFViMJmTkHWUITUCSWSJIiAgE2QZkVc |
| Note: Please ensure your cardHash content is properly URL-encoded (no spaces). | ||||
| cardFirst6 | The first six digits of the credit card number. | unsigned int(6) | Yes | 999999 |
| cardLast4 | The last four digits of the credit card number. | unsigned int(4) | Yes | 9999 |
| cardExpiration | The expiration date of the credit card. | date(MMYY) | No | 1225 |
| cardType | The type of credit card. | char(20) | No | visa |
| referrerid | The referrer ID we have assigned to you. | unsigned int(3) | Yes | 123 |
| tracking_id | The optional tracking ID you would like to assign this user. | unsigned int(10) | No | 456 |
| tracking_key | The optional tracking string value you would like to assign this user. | char(100) | No | banner-54321 |
| currency |
The optional 3-letter currency code to use to bill this user. Defaults to USD if none is passed. Possible values: CHF,GBP,EUR,AUD,CAD |
char(3) | No | EUR |
B. Checking for a Duplicate Email Address
- This action enables you to check for an existing user's email in our system. This returns OK if the email address is not found.
| Name | Description | Type | Required | Example |
| action | The action that should be performed. | char(10) | Yes | checkem |
| custEmail | The email address to check. | char(100) | Yes | foo@example.com |
| referrerid | The referrer ID we have assigned to you. | unsigned int(3) | Yes | 123 |
III. Postback Response
- The following are a list of responses you may receive:
| Response | Description | Applicable Actions | Retry Occurs |
| OK | successful action | all | n/a |
| ERROR_1 | duplicate email address already exists in the system | checkem | No |
| ERROR_2 | recoverable error – typically will be a temporary issue like a database error | join | Yes |
| ERROR_3 | non-recoverable error | all | No |
IV. One-click Auto-login
This script allows a previously posted (in our system) user account to automatically log-in and browse the live cam site. All parameters below are required and some values are encoded, and require our encoding library in order to be generated. Send an HTTPS GET to:
https://oneclick.naiadsystems.com/legacy/oneclick?provider=rocketgate
| Name | Description | Example |
| An encoded string that will be decoded and used as the email address/login username. | fK0c%235I%24tGsI%5Exa | |
| pwd | An encoded string that will be decoded and used for the password. | kpY0pOe%2AG |
| chksm | A computed value generated by the encoding library. | d1a645242585552fbf8a6482aca8f0f5 |
| chksmv | A computed value for the encoding version you are using (generated by the library). | 1.5 |
| rid | The referrer id we have assigned to you | 92 |
Addendum A—OneClickEncoding
The user's email address and password must be encoded with our OneClickEncoding library before being attached to the URL. The encoding library is time-based; therefore the encoded values should be regenerated for every link. The OneClickEncoding library contains specific instructions as to its use. If you don't use the encoding library as stated, the user's email and password will be incorrectly encoded, and the one click will not be completed.
Example URL with all above arguments appended, including the encoded values from our library:
https://processor.naiadbilling.com/api/v1/oneclick/rocketgate?rid=99&email=%21%24v%23j%2Cg%261qFIZ%2BO4lIM%40D&pwd=w%24v%23xgnfJWVb&chksm=bd5b83dc83d712f0a341fc9f1c042783&chksmv=1.5
Addendum B—“repage” Values
| Name | Description | Examples |
| cam | The cam/bio page of a specific model, using the model's nickname. |
repage=cam reargs=OliviaRose |
| category | A category-specific search for models of that type; the available list is found on the front page of your white label. |
repage=category reargs=huge-tits |
| golive | The GoLive chat ad tool. (No reargs required.) | repage=golive |
| golive-iframe | The iframe version of the GoLive chat ad tool. |
repage=golive-iframe reargs=t%3Dbio%26only%3D1%26wmode%3Dopaque%26width%3D316%26height%3D238 |
| tour20 | The iframe tour. Include all the arguments you would normally use in the tour to customize your look and feel. (See Addendum C.) |
repage=tour20 reargs=clr_bg%3D000000%26clr_fg%3DFFFFFF |
| Wild | Set the URL to the page designated in reargs. |
repage=wild reargs=landing/1 |
Addendum C—Creating the Tour reargs Value
Using the tour20 repage value, you can create a tour with one-click links. The possible reargs match the tour's customization parameters. In order to add these parameters to your one-click link, however, they must be URL-encoded.
1. Go to the tour generator:
https://www.[white_label.domain]/exports/code/tour_20/index.php
2. Use the available parameters to customize your tour, then click the “Try it” button to generate the code you want
| Example: | <iframe src="http://www.streamate.com/exports/tour_20/index.php?cols=2&rows=3&df=4096" width="320" height="663" frameborder="0" scrolling="no"></iframe> |
3. To create the reargs value, use the src value and remove everything else.
| Example: | cols=2&rows=3&df=4096 |
4. Convert the parameters to URL-encoding by using the tool:
https://meyerweb.com/eric/tools/dencoder/
Paste the parameters and click the “Encode” button.
| Example: | cols%3D2%26rows%3D3%26df%3D4096 |
5. Use the results as your reargs value and add them to your one-click link.
| Example: | https://oneclick.naiadsystems.com/legacy/oneclick?provider=rocketgate&rid=99&email=%21%24v%23j%2Cg%261qFIZ%2BO4lIM%40D&pwd=w%24v%23xgnfJWVb&chksm=bd5b83dc83d712f0a341fc9f1c042783&chksmv=1.5&repage=tour20&reargs=cols%3D2%26rows%3D3%26df%3D4096 |
6. Set the new one-click link as the src for your iframe.
| Example: | <iframe src="https://oneclick.naiadsystems.com/legacy/oneclick?provider=rocketgate&rid=99&email=%21%24v%23j%2Cg%261qFIZ%2BO4lIM%40D&pwd=w%24v%23xgnfJWVb&chksm=bd5b83dc83d712f0a341fc9f1c042783&chksmv=1.5&repage=tour20&reargs=cols%3D2%26rows%3D3%26df%3D4096" width="320" height="663" frameborder="0" scrolling="no"></iframe> |