Assign values for the additional order fields

Overview

Use this method to assign values to the additional fields for orders.

Use case

1. Add an HTML link or button on your page like the one below.

2. Create a JavaScript click handler to execute the Inline Client desired methods.

3. Set your currency using the TwoCoInlineCart.cart.setCurrency('USD') method.

4. Use the TwoCoInlineCart.cart.setAdditionalFields(additionalFields) method to set the order additional fields values.

5. The additionalFields argument should contain a list of objects with the code of the field and its value.

6. Use the TwoCoInlineCart.products.add({code, quantity}) method to prepare your products.

7. Use the TwoCoInlineCart.cart.checkout() method to show the cart on your page.

Sample request

HTML

<a href="#" class="btn btn-success" id="buy-button">Buy now!</a>

JavaScript

window.document.getElementById('buy-button').addEventListener('click', function() {
  TwoCoInlineCart.cart.setCurrency('USD');

  TwoCoInlineCart.cart.setAdditionalFields([
      // textbox type example
      {
        code     : 'TextInIPNCustom123',
        value    : 'Some text value'
      },
      // listbox type example
      {
        code     : 'SourceOrder',
        value    : 'The WWW'
      },
      // hidden type example
      {
        code     : 'cart2cotestorderhidden',
        value    : 'Some text for the hidden field'
      },
      // checkbox type example
      {
        code     : 'cart2cotestordercheckbox',
        value    : true
      }
  ]);

  TwoCoInlineCart.products.add({
    code: '2CO3MONTHS',
    quantity: 1
  });

  TwoCoInlineCart.cart.checkout();
});

Demo

After defining the additional fields for your orders using the above method, your cart should look like this: