Mighty Bill2 - Use as payment gateway by other applications

Work with Mighty Bill v2 Only

Have you every dreamed to have one corporate place where all orders are precessed from all your websites? Do you want all components like VirtueMart, JoomRes, Member, ... process payment through only one billing system? This is now possible. You can use Bill as gateway.Just like you use PayPal, 2CO, Authorize, Google Checkout, ... You path your order to Mighty Bill and it will do the rest. If you integrate your application with Bill you automaticaly integrate it with 20 payment systems that is integrated with Bill.

Here is the parameters you can use to path to bill.

You should put parameters to following URL http://billdomain.com/index.php?option=com_jsbill

Product Parameters

Parameter	Req.	Def.	Description
item_title{X}	X		This is Title for list of items in bill where {x} is the number of the item. Maximum 1000 Items. Note that first title become the Title of Transaction.
item_amount{X}	X		This is the price for list of items in bill where {x} is the number of the item. Amount should be per 1 unit even if item_qnt{x} bigger than 1.
item_amount_change{X}		0	Allow payee to change price or not. This is good for example for shipping row. When it may varies from country to country, payee may insert shipping price himself
item_qnt{X}		1	Quantity of the items where {x} is the number of the item. This automatically multiply per item_amount{X}.
item_qnt_change{X}		0	Allow user to change quantity or not where {x} is the number of the item.

Tax Parameters

Parameter	Req.	Def.	Description
tax		config	% of tax to apply to bill. If parameter skipped, default tax will be applied from Bill Configuration.
tax_name		VAT	The name of the tax. If parameter skipped, default tax will be applied from Bill Configuration.
tax_change		0	Allow payee to change tax or not. This is good when user pay different tax then your country. Let's sy you have VAT 17% and payee need to pay 20% to get return. Then payee may change it to 20% himself.
tax_chose		0	Allow payee to chose either to pay tax or not.

Order Parameters

Parameter	Req.	Def.	Description
order_number	X		Should be unique. May contain Digits, letters and almost any symbol. for example (#JGD-234:1234)
processors		config	This parameter allow you to overwrite payment processor parameters. For example paypal processor have email parameter that point whom to make payment to. If you add processors[paypaypa_email]=my@email.com then order will be done to that email. That means you may controll if transaction to be recurring and so on. Here is the parameters of core payment plugins Offline payoffline_email= payoffline_subject=MYSITE:: Offline payment request payoffline_cus_subj=MYSITEname:: Payment Instructions payoffline_cus_body=This text will be send to subscriber. Here you can enter your bank information for wire transfer or information for WesternUnion or any other Offline payment. 2Checkout pay2co_vendor= pay2co_lang=ru pay2co_sword= pay2co_id_type=2 pay2co_ids= pay2co_block=0 pay2co_demo=0 PayPal paypaypal_email= paypaypal_currency=USD paypaypal_requre=0 paypaypal_tax=0.00 paypaypal_sandbox=0 Other plugins To get parameters of other plugin you need to see its XML file and see the <param> tag name atribute. Then prefix to that name plugin name. For example you have email parameter of authorize plugin. Then here you may overwrite it by processors[authorize_email]
access		0	Access to pay this bill. 0 means every one. 1 means registered and 2 mans special.
logo		config	logo image URL
return_success		history	Set return success URL. You will get additional parameters passed with this URL. See below. Should be url encoded.
return_fail		history	Set URL to return on transaction fail. Should be url encoded.
price_format		config	Contain of to parts. "00" and "Sign". "00" will be replaced with amount and "Sign" with currency mark. Let's assume we have $10.00. Then "00Sign" = 10.00$, "00 Sign" = 10.00 $, "00-Sign" = 10.00-$, "Sign00" = $10.00,
currency		config	Currency mark, like $, ¥, £, €, ... By default if parameter skipped used from global configuration.
to_user		0	ID to bind bill to particular user only.If set for example 62, then only user 62 can pay this bill. 0 means everyone.
use_user		0	How many times by every user may be used. For example if you set it 1, then every user will be ably to pay this bill only once. This is good when you use the same link for may users. 0 means endless.
use_num		0	Total limit of times to be used no matter what user use it. 0 means endless.
extime		never

Seller/Client Parameters

Parameter	Req.	Def.	Description
client	X	JoomSuite Bill	Client is the name of software that used Bill system
coption	X	com_jsbill	is it is internal software or other component of Joomla then path coption as Component name. later you will be ably to get list of transactions filtered by this name.
seller		config	Array to overwrite default config data for billing person or company. for example seller[inv_name]=nmae&seller[inv_city]=NY Here is the indexes you may use. inv_person inv_name inv_address inv_city inv_country inv_state inv_zip inv_tel inv_fax inv_number - company number inv_tax_id inv_add
seller_id		0	ID of the user who sells anything.
client_id		0	ID of the client record. For example cart or order ID. This ID return with success or fail and you may use to identify what this return from.

All client, order_num and seller options together should be unique.

Here is the URL example

$url = "http://bill.com/index.php?option=com_jsbill";
$url .= "&amp;item_title1=Promotion Book";
$url .= "&amp;item_amount1=30.12";
$url .= "&amp;item_amount_change1=1";
$url .= "&amp;item_qnt1=2";
$url .= "&amp;item_qnt_change1=0";
$url .= "&amp;item_title2=Shipping";
$url .= "&amp;item_amount2=15.20";
$url .= "&amp;item_amount_change2=0"; 
$url .= "&amp;order_num=GE:23 #45"; 
$url .= "&amp;tax=17"; 
$url .= "&amp;client=MyApp"; 
 
header("location: {$url}");

Product Parameters

Tax Parameters

Order Parameters

Seller/Client Parameters

Member Area

Member Activity