Using Automated Transaction Subroutines

This topic describes the automated transaction subroutines.

w3HTMLeComBeg

Starts the Transaction form.

Basic Call

Call w3HTMLeComBeg(“MT”,”TEST0”,”MyTemplate”,”FormName”,”ExtraInfo”)
Parameters

CHID

Item-ID of the Clearing House.

ATSID

Item-ID of the Merchant.

MT.Template

Name of the default template to use.

FormName

Name of the Transaction form. Leave blank if not used.

ExtraInfo

Extra HTML or JavaScript to be inserted in the <FORM …> tag.
Section used from the Template

<!--MT.FormBeg-->

<form method=post action="#MT.URL#" Name="#FormName#" #Extra#>

<!--/MT.FormBeg-->

<!--MT.Required-->

<input type=hidden name=atsid value="#ATSID#">

<input type=hidden

name=usepost value="#USEPOST#">

<!--/MT.Required-->
HTML Result

<!--************** eCommerce FORM BEGIN ***************-->

<form method=post action="https://MyBankURL" Name=”FormName" ExtraInfo>

<input type=hidden name=atsid value="TEST0">

<input type=hidden name=usepost value="1">

The UsePost value comes from the ATS file. A value of 1 tells the bank’s server to return detailed result information from the authorization. The Accept or Decline applications on the database server can then process the returned information.

w3HTMLeComEnd

Ends the Transaction form.

Basic Call

Call w3HTMLeComEnd
HTML Result

</form>

<!-- ************ eCommerce FORM END ************* -->

w3HTMLeComCCInfo

Inserts the credit card section in the Transaction form.

Basic Call

Call w3HTMLeComCCInfo(“MT”,”TEST0”,”MyTemplate”,Email,CCInfo,1200,FormName)
Parameters

CHID

Item-ID of the Clearing House.

ATSID

Item-ID of the Merchant.

MT.Template

Name of the default template to use.

Email

Table of Item-IDs of the EmailSubject and EmailText from either the ATS or the CCInfo file. (See CC.ATS and CC.CCInfo for more detail).

CCInfo

Table containing the credit card information. (See CC.CCInfo for more detail).

Amount

Dollar amount to be debited from the credit card.

FormName

The form name is required only when the CCCheck flag is set to 1. In this case, the form name is used in the JavaScript of the CC.Validation template to validate the Transaction Form before it is submitted to the Internet bank.
Section used from the Template

<!--MT.CC-Required-->

<input type=hidden name=action value="#ACTION#">

<input type=hidden name=amount value="#AMOUNT#">

<input type=hidden name=ccname value="#NAME#">

<input type=hidden name=ccnum value="#CCNUM#">

<input type=hidden name=expmon value="#EXPMONTH#">

<input type=hidden name=expyear value="#EXPYEAR#">

<input type=hidden name=acceptur value="#AcceptURL#">

<input type=hidden name=declineurl value="#DeclineURL#">

<input type=hidden name=AuthOnly value="#AuthOnly#">

<input type=hidden name=PostOnly value="#PostOnly#">

<!--/MT.CC-Required-->
HTML Result

<input type=hidden name=action value="ns_quicksale_cc">

<input type=hidden name=amount value=" 1200.00">

<input type=hidden name=ccname value="Joe Customer">

<input type=hidden name=ccnum value="5454545454545454">

<input type=hidden name=expmon value="01">

<input type=hidden name=expyear value="2001">

<input type=hidden name=accepturl value="http://AcceptURL">

<input type=hidden name=declineurl value="http://DeclineURL">

<input type=hidden name=AuthOnly value="">

<input type=hidden name=PostOnly value="">

The credit card information comes from the CCInfo table. (See CC.CCInfo for more detail).

w3HTMLeComCKInfo

Inserts the electronic check section in the Transaction Form.

Basic Call

Call w3HTMLeComCKInfo(“MT”,”TEST0”,”MyTemplate”,Email,CKInfo,1200)
Parameters

CHID

Item-ID of the Clearing House.

ATSID

Item-ID of the Merchant.

MT.Template

Name of the default template to use.

Email

Table of Item-IDs of the EmailSubject and EmailText from either the ATS or the CCInfo file. (See CC.ATS and CC.CCInfo for more detail).

CKInfo

Table containing the electronic check information. (See CC.CKInfo for more detail)

Amount

Dollar amount to be debited from the credit card.
Section used from the Template

<!--MT.CK-Required-->

<input type=hidden name=action value="#ACTION#">

<input type=hidden name=amount value="#AMOUNT#">

<input type=hidden name=Ckname value="#Name#">

<input type=hidden name=CkAcct value="#CKACCT#">

<input type=hidden name=Ckaba value="#CKAba#">

<input type=hidden name=accepturl value="#AcceptURL#">

<input type=hidden name=declineurl value="#DeclineURL#">

<!--/MT.CK-Required-->
HTML Result

<input type=hidden name=action value="ns_quicksale_check">

<input type=hidden name=amount value=" 1200.00">

<input type=hidden name=Ckname value="Joe Customer">

<input type=hidden name=CkAcct value="65487985098741">

<input type=hidden name=Ckaba value="1210354">

<input type=hidden name=accepturl value="http://AcceptURL">

<input type=hidden name=declineurl value="http://DeclineURL">

The electronic check information comes from the CKInfo table. (See CC.CKInfo for more detail).

w3HTMLeComEMailInfo

Inserts the e-mail section in the Transaction form.

Basic Call

Call w3HTMLeComEMailInfo(“MyTemplate”,Email,”customer@client.com”)
Parameters

MT.Template

Name of the default template to use.

Email

Table of Item-IDs of the EmailSubject and EmailText from either the ATS or the CCInfo file. (See CC.ATS and CC.CCInfo for more detail).

EmailTo

Email address to which order confirmation is sent.
Section used from the Template

<!--MT.Email-->

<input type=hidden name=emailfrom value="#EmailFrom#">

<input type=hidden name=emailsubject value="#EmailSubject#">

<input type=hidden name=emailtext value="#EmailText#">

<input type=hidden name=emailto value="#EmailTo#">

<!--/MT.Email-->
HTML Result

<input type=hidden name=emailfrom value="sales@myshop.com">

<input type=hidden name=emailsubject value="This is your order confirmation">

<input type=hidden name=emailtext value="Your order has been confirmed…">

<input type=hidden name=emailto value=”customer@client.com">

The e-mail information comes from the Email table. (See User Structure Definition for more detail).

w3HTMLeComRecurring

Inserts the Recurring section in the Transaction form.

Basic Call

Call w3HTMLeComRecurring(“MT”,”TEST0”,”MyTemplate”,”2”,”-1”,”30”,”105”)
Parameters

CHID

Item-ID of the Clearing House.

ATSID

Item-ID of the Merchant.

MT.Template

Name of the default template to use.

Cycle

Recurring cycle type. (see CC.RecurCycle for detail).

BillMax

Maximum number of time the recurring cycle is to be active.

Start

Number of days after the initial payment is made before starting the recurring cycle.

Amount

Dollar amount to be debited on a recurring basis.
Section used from the Template

<!--MT.Recurring-->

<input type=hidden name=Recur_create value="1">

<input type=hidden name=Recur_Billingcycle value="#RecurCycle#">

<input type=hidden name=Recur_Billingmax value="#RecurMax#">

<input type=hidden name=Recur_start value="#RecurStart#">

<input type=hidden name=Recur_amount value="#RecurAmount#">

<!--/MT.Recurring-->
HTML Result

<!--MT.Recurring-->

<input type=hidden name=Recur_create value="1">

<input type=hidden name=Recur_Billingcycle value="2">

<input type=hidden name=Recur_Billingmax value="-1">

<input type=hidden name=Recur_start value="30">

<input type=hidden name=Recur_amount value="105.00">

<!--/MT.Recurring-->