TrackBee DocsTrackBee Docs
Tracking SDKEvents

payment_info_submitted

Someone submitted their payment details at checkout.

Send this when a visitor has entered payment details and the checkout is one step from done.

trackbee.track('payment_info_submitted', {
  email: 'sam@example.com',
  phone: '+31612345678',
  first_name: 'Sam',
  last_name: 'de Vries',
  address1: 'Oudegracht 12',
  address2: 'Apt 3',
  city: 'Utrecht',
  country_code: 'NL',
  currency: 'EUR',
  line_items: [
    {
      product_id: '8472019',
      variant_id: '4410228',
      price: '29.99',
      quantity: 2,
      currency: 'EUR',
      product_title: 'Field Jacket',
      sku: 'NB-FJ-OLV-M',
    },
  ],
});

Fields

Every field is optional. The event sends even with an empty object, though an empty one tells you little.

FieldType
emailstring
phonestring
first_namestring
last_namestring
address1string
address2string
citystring
country_codestring
line_itemslist of line items, may be empty
currencystring

Send the contact details you have. They are what lets your ad platforms match this checkout to a real person, which is most of the value of this event.

phone should be in international format, like +31612345678. country_code is a two-letter ISO code like NL or US.

The address fields above are the shipping address.

Billing address

If the shopper gave a separate billing address, send it under its own billing_ fields.

FieldType
billing_first_namestring
billing_last_namestring
billing_phonestring
billing_address1string
billing_address2string
billing_citystring
billing_country_codestring
trackbee.track('payment_info_submitted', {
  email: 'sam@example.com',
  first_name: 'Sam',
  last_name: 'de Vries',
  address1: 'Oudegracht 12',
  city: 'Utrecht',
  country_code: 'NL',
  billing_first_name: 'Nadia',
  billing_last_name: 'de Vries',
  billing_address1: 'Vijzelstraat 40',
  billing_city: 'Amsterdam',
  billing_country_code: 'NL',
});

Do not copy the shipping address into these

Send billing_ fields only when the shopper actually gave a separate billing address. Copying the shipping values across claims an address you were never told. When billing and shipping are the same, leave the billing_ fields out: the receiving end falls back to the shipping address on its own.

This is the only event that takes a billing address. checkout_completed takes the shipping address only.

Set currency on every line item

Line items do not inherit the currency you set on the event. Set it on each line.

The minimum

trackbee.track('payment_info_submitted', {
  email: 'sam@example.com',
});

On this page