eCommerce Integration
Section 3: Submission Method 1 (Individual Items in a Collection).
This method will treat each item as its own order which will allow the manipulation of that individual product without affecting other items that were in the same cart. It also allows us to compile more specific analytical data and report it back to the merchant for their use.
NOTE:
If you cannot calculate shipping and tax amounts on a per item basis please use Submission Method 2 (All Items in a Bundle). Due to the nature of the layaway process and Submission Method 1, total shipping and tax amounts cannot be assigned to a single item for the entire cart. If the consumer were to cancel this item the shipping and tax can not be transferred to the next item. Please only use Submission Method 1 if you can allocate specific tax and shipping amounts on a per item basis.
Example:
If a consumer purchases a Television and VCR in one cart and then later on the VCR becomes unavailable or the member wishes to change their payment schedule the VCR would be the only one affected in this method. From a customer support perspective this is much more helpful.
What is needed?
You will have to add the following required fields alongside the previously created fields. In addition you will have to identify each item within the cart. To do this the item name field is held to _n, where n is a number starting at 1 for the first item and increases by 1 for each additional item. You will also see optional fields for items that require tax, shipping, or quantity values. These values correspond to the item with the same value of "n". (i.e. amount_2 would refer to item_name_2).
| Field | Description | Inclusion |
|---|---|---|
| cmd | This field declares the submission method to our server. Set this value to "new_purchase_collection" in order to submit individual items in a bundle. (This field only needs to be included once). | required |
| item_name_n | Specify the item name your customer will see during the eLayaway checkout process. Since you need to send at least one item, the first item would be listed as item_name_1. | required |
| item_number_n | Stores the item number you will use to identify a product referenced by n. | optional |
| amount_n | The amount for a single item referenced by n. If quantity is specified, the amount will be multiplied by quantity for the total gross pre tax amount. | required |
| tax_n | Stores the tax cost for the item referenced by n. (defaults to 0 if it is not sent) | optional |
| shipping_n | Stores the shipping cost for the item referenced by n. (defaults to 0 if it is not sent) | required |
| quantity_n | The number of items for the item referenced by n. (defaults to 1 if it is not sent) | required |
Here is an example of the input fields you need to add to your form. This example covers the addition of a single item. Note that all values for these input fields should be generated by your cart's code:
Once you have added the required fields to your form you will have to include the eLayaway calculator on the checkout page.