Chapter 3. VipResellers.com Billing Process

The chapter explains how to resell web templates through the reseller shop.

1. Billing Process

Before developing your own software to proceed with an automatic resale of web templates make sure your reseller account is verified by Templatemonster staff and you have enough funds in your reseller balance to process your customers' sales.

By reselling web tempates we understand the process of accepting and processing payments of your customers by your party and sending instructions on how to download a specific template(s) to the email of the customer who placed an order at your website by our party.

As soon as customers' payments are processed by the reseller a billing script (developed by Templatemonster) should be invoked by the reseller to have an email with download links to be sent to the customer.

Script URL:

https://secure.vipresellers.com/reseller/resell.php

Synopsis:

https://secure.vipresellers.com/reseller/resell.php?login=<login>&template[0]=<template_number>&template[1]=<template_number>...&template[n]=<template_number>&exclusive=<is_exclusive_purchase>&customer=<cuctomer_email>&checksum=<transaction_md5_checksum>

Parameters:

ParameterDescription
login=<login>The login to identify this transaction as yours. This is the username you use to log in your reseller account.
template[0]=<template_number> &template[1]=<template_number> ... &template[n]=<template_number>A list of templates to resell
&exclusive=<is_exclusive_purchase>Equals 1 for an exclusive template purchase (for a single template purchase only). Equals 0 for a non-exclusive template purchase.
&customer=<cuctomer_email>A customer's e-mail address. We will send a letter with download links to this e-mail address.
checksum=<transaction_md5_checksum>It is a digital sign of this transaction to confirm your authority. It is an MD5 checksum, calculated from transaction identification string. This string consists of four parts: "<login><list_of_templates><is_exclusive_purchase><customer_email><secret_word>".

You can set a secret word on the Account Details page of your reseller account.

Example 1:

To send download links for templates #1345 (non-unique purchase); #1234 (non-unique purchase); and #9001 (non-unique purchase) to the customer's email address info@acmedot.com you should, firstly, calculate an md5 checksum:

md5("tmreseller1345123490010info@acmedot.comgoogle") = 2335ab61805fe9dc3d97dec186f0be62

where:

tmreseller - a username of the reseller

info@acmedot.com - an email address of the customer

google - your secret word

and secondly, invoke a script:

https://secure.vipresellers.com/reseller/resell.php?login=tmreseller&template[0]=1345&template[1]=1234&template[3]=9001&exclusive=0&customer=info%40acmedot.com&checksum=2335ab61805fe9dc3d97dec186f0be62

where:

tmreseller1 - a username of the reseller

Example 2:

To send download links for templates #1235 (unique purchase) and #9025 (unique purchase) to the customer's email address support@customerwebsite.com you should, firstly, calculate an md5 checksum:

md5("tmreseller123590251support@customerwebsite.comgoogle") = 36ed447694a1a80773a41a5f8b3cfde6

where:

tmreseller - a username of the reseller

support@customerwebsite.com - an email address of the customer

google - your secret word

and secondly, invoke a script:

https://secure.vipresellers.com/reseller/resell.php?login=tmreseller&template[0]=1235&template[1]=9025&exclusive=1&customer=support%40customerwebsite.com&checksum=36ed447694a1a80773a41a5f8b3cfde6

Note:

You can invoke the billing script only from a host or a subnet specified in a 'Payment Script IP' field of the Account Details page of your account. Please, contact to change your ip-address or a subnet mask.

Note 2: You can use either POST or GET method to invoke this script.

Note 3: Do not forget to encode an e-mail addresses with an URL encoding if you use GET method.

Response:

When invoking a billing script you can get one of the following responses in a plain text format:

Response TypeDescription
Result: OK
The script was invoked with correct parameters from the correct subnet. The balance was enough to process the request, so the order was processed, an email with download links was sent to the customer, a sales notification email was sent to your email address, and an appropriate amount was subtracted from your reseller account.
Result: ERROR 
Error: not enough parameters
One of parameters is missing.
Result: ERROR 
Error: wrong login 
The login specified in the billing script can't be found in the database.
Result: ERROR 
Error: wrong ip 
The IP address of the host that invoked the billing script does not match the IP adress or IP subnet mask specified as 'Payment Script IP' in your account.
Result: ERROR 
Error: wrong template number 
Template: #NNN 
A template #NNN can't be found in the database. Please, use our WebAPI to obtain a list of available templates.
Result: ERROR 
Error: template is hidden 
Template: #NNN 
A template #NNN was temporarily removed from the database by TemplateMonster staff. This could happen as a result of the fact that we discovered a technical error in the product and temporarily made it unavailable for the purchase. Please, use our WebAPI to obtain a list of available templates.
Result: ERROR 
Error: template is sold 
Template: #NNN 
A template #NNN was permanently removed from the database as it had been sold exclusively. We can't sell it once again. Please, use our WebAPI to determine which templates have been sold exclusively.
Result: ERROR 
Error: wrong checksum 
The calculated checksum does not match the checksum you posted.
Result: ERROR 
Error: not enough money 
Your balance is not enough to process an order. A notification email will be sent to your e-mail address.
Result: ERROR 
Error: duplicate order 
Duplicate order.
Result: ERROR 
Error: incorrect email 
Incorrect email.