Custom Fieldsanchor

Custom fields allow you to customize your checkout experience by collecting specific information about your customers and their purchases.

You can include custom fields when:

Custom field typesanchor

There are two types of custom fields: Pass Thru fields and Store and Pass Back fields.

Pass Thru fieldsanchor

Pass Thru fields are designed to pass a value from your checkout form to your servers, where you can either store or respond to the data. For example, if you have a checkbox for "Join Mailing List" on your checkout form and you pass this data through as a custom field, your servers can respond by adding the customer to your mailing list.

While Pass Thru custom fields are configured in the Control Panel, they can only be used to pass data via the API.

Store and Pass Back fieldsanchor

The data passed by Store and Pass Back fields is stored in the Control Panel and returned via the API on the transaction response object. It's also available for download via a Transaction or Vault Search. Keep in mind that you can only search for the data passed within a Store and Pass Back field; you won’t be able to search for the field name itself.

Creating a custom fieldanchor

Custom fields can only be configured directly in the Control Panel by users with the Add/Edit Processing Options role permission. There isn’t a way to set up new custom fields via the API.

To create a custom field:

  1. Log into the Control Panel
  2. Click on the gear icon in the top right corner
  3. Click Processing from the drop-down menu
  4. Scroll to the Transactions section
  5. Next to Custom Fields, click the Options link
  6. Click the Add link located on the right side of the page
  7. Enter a custom field API name to pass with your code
    • This value must be less than or equal to 255 characters and can't contain any spaces or capital letters
  8. Enter a display name
    • This is what will appear in your transaction history and Vault records
  9. Under the Options section, select either Store and Pass Back or Pass Thru
  10. Click the Add Custom Field button

Editing a custom fieldanchor

In order to edit custom fields in the Control Panel, your user's role must have the Add/Edit Processing Options role permission enabled. To edit a custom field:

  1. Log into the Control Panel
  2. Click on the gear icon in the top right corner
  3. Click Processing from the drop-down menu
  4. Scroll to the Transactions section
  5. Next to Custom Fields, click the Options link
  6. Click the link located in the Display Name column of the field you'd like to edit
  7. From here, you can:
    • Change the field's display name
    • Toggle between Store and Pass Back and Pass Thru field types
  8. Click the Save button

Deleting a custom fieldanchor

note

You can only delete custom fields that have never been used to collect customer or transaction data.

In order to delete custom fields in the Control Panel, your user's role must have the Add/Edit Processing Options role permission enabled. To delete a custom field from the Control Panel:

  1. Log into the Control Panel
  2. Click on the gear icon in the top right corner
  3. Click Processing from the drop-down menu
  4. Scroll to the Transactions section
  5. Next to Custom Fields, click the Options link
  6. Click the X icon located to the right of the field you'd like to remove
  7. Click the Yes button to confirm

Viewing the custom fields created through Fraud Protection Advancedanchor

If you are using Fraud Protection Advanced, you can add a specific set of custom fields that pertain to your business in certain filter conditions to mitigate fraud. For more information, see Fraud Protection Advanced.

To use these custom fields, you will need to add them via the Fraud Protection Advanced Dashboard. After new fields are added in the Dashboard, you will also see these fields in the Control Panel.

To find these custom fields in the Control Panel:

  1. Log into the Control Panel
  2. Click on the gear icon in the top right corner
  3. Click Processing from the drop-down menu
  4. Scroll to the Transactions section
  5. Next to Custom Fields, click the Options link
  6. From here, you can see all your ACTIVE custom fields added through the Fraud Protection Advanced dashboard