Applying the Local Checkout server behavior
The Local Checkout server behavior configures the necessary server-side code to process a transaction from a checkout page. It works in conjunction with a checkout form created using the Insert Checkout Form feature, and the configuration dialog is launched immediately upon completing the Insert Checkout Form wizard.
Setting up the server behavior is accomplished through a five step wizard, the details of which are described below. These steps configure the variables specific to your payment gateway that need to be passed to it containing your merchant information, details about the transaction, and your credit card information. It also configures the redirect destination for a successful transaction and a failed transaction. Finally, it provides the option of configuring PayPal's Express Checkout merchant gateway as an alternate checkout method on your page.
Setting up the server behavior is accomplished through a five step wizard, the details of which are described below. These steps configure the variables specific to your payment gateway that need to be passed to it containing your merchant information, details about the transaction, and your credit card information. It also configures the redirect destination for a successful transaction and a failed transaction. Finally, it provides the option of configuring PayPal's Express Checkout merchant gateway as an alternate checkout method on your page.
To access the Local Checkout server behavior
The Insert Checkout Form feature is accessible in the following locations in Dreamweaver:- Server Behaviors > eCart > Checkout > Insert Checkout Form > Local Checkout configuration
- Server Behaviors > eCart > Checkout > Local Checkout
To configure the Local Checkout server behavior:
- Open the page that will submit your transaction to the merchant gateway.
- In the Server Behaviors panel, click the Plus (+) icon and select eCart > Checkout > Local Checkout
The Local Checkout dialog opens.
- From the payment gateway list, select your payment gateway.
- Select the eCart object on the page specific to the shopping cart for which the transaction is being processed.
- Select the trigger on the page that will submit the transaction to your gateway.
- Enter the Success and Failure redirect destinations that the end user will be directed to upon processing the transaction. This can be a relative URL or an http:// location.
- Click Next.
- The second step is to enter the required fields specific to your merchant gateway. These are required variables that must be passed in order to complete the transaction.
Variable information is updated by selecting the variable in the pane and entering its corresponding info in the Value textfield. The majority of variables already contain the required default values and do not need to be updated. Only your account specific information is required.
Descriptions of each are available at the base of the display pane by selecting the variable.
Information specific to these variables can be found in the documentation for your merchant gateway. See Local Checkout for more information.
Upon completing configuration of the variables, click Next. - The third step is configuration of the variables that pass the shopping cart information.
Each of these variables comes pre-populated with the server-side code specific to passing the details in your shopping cart. It is recommended that you use these default values and do not attempt to modify this configuration unless you are an experienced developer with an understanding of the architecture of eCart.
Charge amount passes the shopping cart total.
The Order ID for your transaction to uniquely identify it is based of the current server session.
The pane at the bottom contains the data for your shopping cart columns specific to each item in the cart. This configuration checks the configured column values for the specified fields and loops through all the items currently in the cart to pass the line item details to the gateway.
The default configuration contains the total cost for a quantity of a given item, the description of the items, the ID for the items, and the total number of each unique item within the shopping cart.
Additional information to pass can be added by entering it in the Field name: and Value: textfields and clicking the Plus (+) icon. Fields can be removed by selecting them within the pane and selecting the Minus (-) icon.
Upon completing configuration of the variables, click Next. - The fourth step is to configure the optional fields that can be passed to the gateway specific to your transaction.
Variable information is updated by selecting the variable in the pane and entering its corresponding info in the Value textfield. Most variables already contain the required default values and do not need to be updated.
Information specific to these variables can be found in the documentation for your merchant gateway. See Local Checkout for more information.
Upon completing configuration of the variables, click Next.
- The final step of the wizard is the option to add PayPal's Express Checkout as an additional payment option on the page.
If you wish to add this option on the page, click the Use PayPal Express Checkout checkbox.
Select the trigger on the page that initiates payment processing through PayPal.
Variable information is updated by selecting the variable in the pane and entering its corresponding info in the Value textfield. Some variables already contain the required default values and do not need to be updated.
Be sure to enable the Sandbox to process test transactions and avoid posting unnecessary transactions and refunds through your live account. You can re-access the server behavior to enable your live account.
Please refer to the section detailing PayPal Express Checkout Authentication for more information on configuration of variables specific to PayPal's Express Checkout payment gateway.
Click Finish to apply the server behavior to the page.