Analytics and Tracking

add_payment_info

Also called add payment info event

A GA4 recommended ecommerce event sent when a shopper submits their payment details during checkout, just before the purchase.

Quick facts: add_payment_info

Category
Analytics and Tracking
Also called
add payment info event
Level
Intermediate
Affects
Checkout funnel reports, ecommerce tracking, payment-step drop-off analysis
Where to see it
GA4 DebugView, GA4 funnel exploration, Google Tag Manager, Shopify or WooCommerce analytics
In this article4
  1. How add_payment_info works
  2. Why it matters
  3. Common mistakes
  4. How to act on it

add_payment_info is a recommended ecommerce event in Google Analytics 4 that a website sends when a shopper submits their payment details during checkout. It marks the step between choosing delivery and completing the order, so you can see how many people reach the payment stage and how many of those go on to buy.

How add_payment_info works

GA4 has a standard sequence of recommended events for online shops. In a typical checkout they run in this order:

  1. begin_checkout when the shopper starts checkout;
  2. add_shipping_info when they choose a delivery option;
  3. add_payment_info when they submit a payment method;
  4. purchase when the order is confirmed.

The event takes the usual ecommerce parameters: currency (GBP for a UK shop), value, an optional coupon, an items array listing the products, and payment_type, which describes the method, such as card, PayPal, Apple Pay or a buy-now-pay-later option like Klarna. Platforms such as Shopify and WooCommerce plugins often send it automatically; custom sites push it into the data layer and fire it through Google Tag Manager.

The payment_type parameter should only ever be a label. Card numbers, names and billing addresses must never be sent to GA4.

Why it matters

The payment step is where many otherwise good checkouts fail. A shopper who has chosen delivery has shown strong intent, so a big drop between add_payment_info and purchase usually points to a specific problem: a card declined by 3D Secure authentication, a payment page that breaks on mobile, a missing wallet option or a surprise charge at the last moment.

With add_payment_info in place, a funnel exploration can show the drop at each step, broken down by device, browser or payment_type. A Glasgow gift shop might find that mobile shoppers choosing PayPal complete far less often than card users, which turns a vague “checkout problem” into one thing to test.

When the payment page is hosted elsewhere, such as a PayPal or Stripe page, the shopper leaves your domain. Without the right referral settings, the returning visit can start a new session credited to the payment provider rather than the original channel, which damages attribution.

If you also advertise on Facebook and Instagram, Meta has a matching standard event, AddPaymentInfo. Firing both from the same data layer push keeps your GA4 funnel and your ad reports describing the same step, so when purchases fall you can see whether the problem started at payment or earlier.

Common mistakes

  • Firing the event when the payment page loads rather than when details are submitted, so it simply duplicates begin_checkout.
  • Leaving out the items array, which GA4 needs to report products in the checkout.
  • Sending value as text with a pound sign instead of a number.
  • Putting card or personal details into parameters.
  • Not listing payment providers as unwanted referrals, so sales are credited to them.

How to act on it

Place a test order and watch GA4 DebugView to confirm all four checkout events fire in order, each with currency, value and items. Then build a funnel exploration from begin_checkout to purchase and compare devices.

If the payment step loses more people than you would expect, test the payment journey yourself on a phone with each method you offer. Add payment providers to GA4’s list of unwanted referrals.

Finding where checkouts leak is a regular part of the ecommerce ads work I do for UK shops, because fixing the checkout can do more for return on ad spend than any change to the ads.

Do and do not

Do

  • Fire the event when payment details are submitted
  • Include currency, value, items and payment_type
  • Add payment providers to GA4's unwanted referrals

Do not

  • Send card numbers or personal details in parameters
  • Fire it on payment page load
  • Send value as text with a pound sign

Questions people ask about this

Is add_payment_info required for GA4 ecommerce?

It is not required, but it is strongly recommended if you want to see where checkouts fail. Without it, GA4 cannot separate drop-off at the delivery step from drop-off at the payment step. Many shop platforms send it automatically, so check before building it yourself.

What should I put in the payment_type parameter?

A simple label for the method chosen, such as card, PayPal, Apple Pay, Google Pay or Klarna. Keep the labels consistent so reports group correctly. Never include card numbers, names or any other personal details.

Why does add_payment_info show more events than purchase?

That gap is normal and is the drop-off at the final step. Some shoppers abandon at authentication, some payments fail and some change their minds. A large gap, especially on one device or payment method, is worth investigating by testing that route yourself.

Related terms

Found this useful?

Share it, or ask an AI to summarise it

Back to the glossary

Knowing the term is the easy part

Applying it to your own site and budget is the work. Book a call and I will tell you what actually applies to you.