API/biller integration

From Webcamwiz
Jump to: navigation, search

Preface

This document describes how to upsell to your webcam white label site by providing billing information for your user.

The billing information should be provided as an encrypted JSON object as will be described in this document

This JSON data collection is specific and different for each billing service.

Currently Paycom and CCBill payment services are supported.

This encrypted object may be added to any link or promo tool you are currently using to send traffic to your white label, it should be added to the URL as the "bs" parameter.

Parameters Encryption & Encoding

The billing information provided on the link should be encrypted and encoded by performing the following steps:

  • Encryption method: AES
  • Cipher: CBC
  • Padding Mode: Zeros
  • Vector: 146, 64, 191, 111, 23, 3, 113, 119, 231, 121, 252, 112, 79, 32, 114, 156
  • Key: Provided key (the key is a private key provided to you)
  • Encoding: UTF8
  • Parameter Construction:
    • Construct the required JSON data object for the specific payment service.
    • Encrypt the JSON object.
    • Convert the encrypted string to Base64 string.
    • URL encode the result string.

Like this:

HttpURLEncode(ConvertToBase64String(AESEncryption(JSON)))

Samples

Sample Direct Link

http://www.mywhitelabel.me/services/directlinkhandler.ashx?wid=2114229390&promocode=bcodej0000046_00000&ptype=1&queryid=1&
bs=OXd0S1dkUVRBbTdtUTRVVEpRb0VYZmRRcFh4dm94djk5U2l6R3NadnAzd0pKUHVhS0lEU1ZaTFgxbUFuVThMWDU5VWJTVyUyRmc5dzlqcW5sZzJaJTJGeiUyQmxGNkNu
YVk4JTJGSDAlMkJOTzdMWWVBdmhhcXhiQTJMUnJkaCUyRmZDbW5CRGVtcmlrSmw4T1d1Z1FkUDBuWVdjSXRIbTN3S0Q3JTJCZ0lpbndWNFZFaEdsZW9LcFN6ZGt3OVRxNzJ
kaTU1ekU4bkg1UGJlMnZjQ080ZG9rbVlSbSUyRnhJcFduMmR2OGdGM1FPR3VCY0dXM0h2dWVqR2xsYUJGZ2hhRU9OcFdUTDV0ZmZQMUNGNGclMkJGSVYzVG1JQk5Fd1NHWS
UyQkFwJTJGYURCMmN5V0lQa09qNm5rMkdhdFFmZ0NNODUlMkZnRWJSem95aDBFanRmOXF2c3NoNzVYdXNMS1VHRjhRNUpvd0FzNGNXRkklMkJ5VVA2RWJyVGU3bDB6YU5Eb
npxVXFIS2xtcGlwd1VMY01nU1FKVTdsUyUyRlF3Z21iamw1cjlwZGdhTzJ3UkRyNWtSd09tTnlCUlR3ayUyQnU1VSUzRCUwQQ==

Sample iframe

<iframe src="http://ads.livepromotools.com/wlgbannerv1.ashx?template=2036&wid=2114229390&promocode=bcodeb7ad263d_00000&pid=-20178&
ptype=1&queryid=1"&
bs=OXd0S1dkUVRBbTdtUTRVVEpRb0VYZmRRcFh4dm94djk5U2l6R3NadnAzd0pKUHVhS0lEU1ZaTFgxbUFuVThMWDU5VWJTVyUyRmc5dzlqcW5sZzJaJTJGeiUyQmxGNkNuYVk4J
TJGSDAlMkJOTzdMWWVBdmhhcXhiQTJMUnJkaCUyRmZDbW5CRGVtcmlrSmw4T1d1Z1FkUDBuWVdjSXRIbTN3S0Q3JTJCZ0lpbndWNFZFaEdsZW9LcFN6ZGt3OVRxNzJkaTU1ekU4b
kg1UGJlMnZjQ080ZG9rbVlSbSUyRnhJcFduMmR2OGdGM1FPR3VCY0dXM0h2dWVqR2xsYUJGZ2hhRU9OcFdUTDV0ZmZQMUNGNGclMkJGSVYzVG1JQk5Fd1NHWSUyQkFwJTJGYURCM
mN5V0lQa09qNm5rMkdhdFFmZ0NNODUlMkZnRWJSem95aDBFanRmOXF2c3NoNzVYdXNMS1VHRjhRNUpvd0FzNGNXRkklMkJ5VVA2RWJyVGU3bDB6YU5EbnpxVXFIS2xtcGlwd1VMY
01nU1FKVTdsUyUyRlF3Z21iamw1cjlwZGdhTzJ3UkRyNWtSd09tTnlCUlR3ayUyQnU1VSUzRCUwQQ==
scrolling="no" marginwidth="0" marginheight="0" align="middle" width="300" height="250" frameborder="no" 
allowtransparency="true"></iframe>

CCBill billing information

Required Data

Name

Type

Notes

* tokeninfo

string

CCBill cross sell token info (use generateSessionForCrossSale)

* email

string

valid e-mail address of the user

* username

String

The username of the user. (4-25 characters)

* Password

String

The password of the user. (4-25 characters)

sendemail

Int

0/1 – send to the user welcome e-mail with login details (1 is default).

cultureid

Int

1 English

2 Italian

3 French

4 German

5 Spanish

6 Portuguese

13 Hindi

15 Dutch

18 Russian

21 Swedish

25 Arabic

Set the default culture of the user

The default value is English.

* timestamp

Int

Current Unix timestamp (seconds since midnight, January 1 st , 1970) in UTC.

* Mandatory parameters

Example - JSON Object Before Encryption

{

"tokeninfo": "NOPP27QLX7FZ32POIPWT3JYYZDZBEZBYFIZWV5SAVG6BN3WLWMIYE211PGMSOY5JE2MP5FD6KIYR3EUQQTNIOJ7Y6EJEYLP7UYP2ZTA%3D",

"email": "john.smith@mail.com",

"username": "johnsmith",

"password": "d8a649f",

"sendmail": 1,

"cultureid": 1,

"timestamp": 1405005375

}

Epoch billing information

Required Data

Name

Type Notes
co_code string Epoch company code
picode string Epoch product code for the user's membership
memberid string The original member id of the user provided by Epoch.
email string valid e-mail address of the user
username String The username of the user. (4-25 characters)
Password String The password of the user. (4-25 characters)
sendemail Int 0/1 – send to the user welcome e-mail with login details (1 is default).
cultureid Int

1 English

2 Italian

3 French

4 German

5 Spanish

6 Portuguese

13 Hindi

15 Dutch

18 Russian

21 Swedish

25 Arabic

Set the default culture of the user

The default value is English.

timestamp Int Current Unix timestamp (seconds since midnight, January 1 st , 1970) in UTC.

Example - JSON Object Before Encryption

{

"cocode": "q24",

"picode": "cvujve7p450123",

"memberid": 123456,

"email": "john.smith@mail.com",

"username": "johnsmith",

"password": "d8a649f",

"sendmail": 1,

"cultureid": 1,

"timestamp": 1405005375

}

NetBilling billing information

Required Data

Name Type Notes
accountId string The account id of the user in NetBilling
transactionid string The ID of the last transaction of the user, to be used for the 1click purchase.
sitetag string The site tag of the user in NetBiling
email string valid e-mail address of the user
username string The username of the user. (4-25 characters)
password string The password of the user. (4-25 characters)
useragent string The user agent of the user's browser.
ip string The IP address of the user.
timestamp long Obtain the current Unix timestamp (seconds since midnight, January 1 st , 1970) in UTC

Example - JSON Object Before Encryption

{

 "username": "a33256b",
 "password": "d8a649f",
 "email": "john.smith@mail.com",
 "timestamp": "1405005375",
 "accountId": "112167236985",
 "transactionid": "195406467",
 "sitetag": "LiveCam",
 "ip": "192.118.133.1",
 "useragent": "Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/35.0.1916.153 Safari/537.36" 

}

RocketGate billing information

Required Data

Name Type Notes
referring_merchant_id string Your Rocketgate merchant ID
referred_customer_id string Your Rocketgate customer ID
card_hash string Your Rocketgate cardHash
email string valid e-mail address of the user
username string The username of the user. (4-25 characters)
password string The password of the user. (4-25 characters)
useragent string The user agent of the user's browser.
ip string The IP address of the user.
sendemail int 0/1 – send to the user welcome e-mail with his login details.
timestamp long Obtain the current Unix timestamp (seconds since midnight, January 1 st , 1970) in UTC
cultureid int Set the default culture of the user.
1 English
2 Italian
3 French
4 German
5 Spanish
6 Portuguese
13 Hindi
15 Dutch
18 Russian
21 Swedish
25 Arabic
The default value is English