Skip to main content
TrackingConsultingFree audit
Square → PinterestIntegration guide

Connecting Square to Pinterest

Square holds the transaction, and for most Square businesses the majority of those transactions are a card tapped at a counter with no browser anywhere near them. Pinterest is a save-now-buy-later platform, which makes its attribution window the loosest of any network here and its conversion data the most delayed. The join between them succeeds or fails on one thing: whether the epik click identifier reaches the Square payment or order before the conversion happens, because Pinterest can only match a conversion it can tie back to a click it recognizes.

Get my free conversion tracking auditSee what we check

Free30 minutesNo obligation

By Ariful IslamSquare → Pinterest, in short ↓

Specific to this pair

Square Online stores on Pinterest: catalog first, then CAPI

Measure Pinterest against Square Online orders only. Subscribe to Square's order webhooks, filter to the online channel, and send checkout events with the order ID as event_id matching the tag, plus epik captured on your landing page. Shopping ads need a catalog feed from Square or a third-party tool. Keep pickup and in-store payments out.

Pinterest fits Square sellers with visual products sold online: boutiques, home goods, bakeries taking cake orders. It does not fit the in-person side, because a Pin saved for later and a card tapped weeks after in a shop have no join at all. Measure Pinterest against Square Online orders only.

Check what Square Online supports for the Pinterest tag in its marketing integrations; if it cannot install the tag directly, the checkout event will need your own setup. For server events, subscribe to Square's order webhooks, filter to the online channel, and send checkout events with the order ID as event_id, matching whatever the tag sent. The epik value must be captured on your own landing page and carried into Square Online checkout, which runs on Square's hosted pages, so the server event can include it.

Pinterest shopping ads need a product feed. Check whether Square can export a catalog feed Pinterest accepts or whether you need a third-party feed tool; without it Pinterest knows you made sales but not which products sold. Leave pickup and in-store payments out of the feed to Pinterest even when the customer is identified, since Pinterest had no measurable part in them and they would inflate its numbers.

Square → Pinterest · what breaks

Why this join usually fails — Square → Pinterest

  1. 01

    The epik click identifier never reaches Square

    Square Online checkout is hosted, so the identifier must be carried deliberately rather than by cookie. For in-person payments there is no identifier at all unless the customer booked an appointment or is in the customer directory — a walk-in who taps a card cannot be joined to an ad click by anyone.

  2. 02

    Most of the revenue has no browser

    A card at a terminal has no click, no session and no identifier. That is a boundary to measure rather than a bug to fix, and the honest deliverable includes how much of your revenue sits outside it.

  3. 03

    The save-now-buy-later gap

    Pinterest's whole behaviour model is saving something for later. A share of the revenue it genuinely drives arrives months after the click and outside any attribution window, and no build changes that. Say it before anyone sets a target.

  4. 04

    Nothing reconciles afterwards

    Pinterest Ads Manager reports events received and their match status. A successful API call is not a matched conversion — reconcile Pinterest's reported conversions against your own records for the same window and expect a structural gap from the save-then-buy delay.

Square → Pinterest · the fix

What working looks like — Square → Pinterest

  • The epik click identifier on every transaction

  • Conversions arriving in Pinterest

    Conversions appear in Pinterest Ads Manager against the campaign, with the value you sent, and become usable for optimization.

  • Reconciled against the source

Square → Pinterest · architecture

How Square and Pinterest actually connect

  1. 1

    Square holds the truth

    Square records every payment with its amount, channel and, where the customer is identified, a link to the customer directory. That directory is the only bridge between a counter payment and anything that happened online.

  2. 2

    Pinterest needs a click to match

    Pinterest matches server events using the click identifier where present and hashed customer information otherwise. Confirm current endpoint and field names against Pinterest's own documentation — its Conversions API has been through more than one revision.

  3. 3

    The identifier is the bridge

    The epik click identifier, captured at the visit and carried into the Square payment or order.

  4. 4

    The event source decides reliability

    Subscribe to payment and order events and send from your server. This covers online orders cleanly, and covers in-person payments only for the share you can join to an identity.

  5. 5

    Deduplication at the destination

    Pinterest deduplicates on event_id, so the tag and the server event must carry the same value for the same conversion. Pinterest volumes are often low enough that a doubling reads as a good week rather than a bug, which is why this needs testing deliberately rather than assuming.

Square → Pinterest · normal or broken

Working vs. broken, side by side — Square → Pinterest

Normal, not a fault

  • The epik click identifier present on the transaction

  • Sent from the Square payment webhook

  • Deduplicated correctly

    Pinterest deduplicates on event_id, so the tag and the server event must carry the same value for the same conversion. Pinterest volumes are often low enough that a doubling reads as a good week rather than a bug, which is why this needs testing deliberately rather than assuming.

  • Reconciles with the source

Actually broken

  • The epik click identifier missing on most records

    Square Online checkout is hosted, so the identifier must be carried deliberately rather than by cookie. For in-person payments there is no identifier at all unless the customer booked an appointment or is in the customer directory — a walk-in who taps a card cannot be joined to an ad click by anyone.

  • Sent from the browser

    A card at a terminal has no click, no session and no identifier. That is a boundary to measure rather than a bug to fix, and the honest deliverable includes how much of your revenue sits outside it.

  • Counted twice, or not at all

    Pinterest's whole behaviour model is saving something for later. A share of the revenue it genuinely drives arrives months after the click and outside any attribution window, and no build changes that. Say it before anyone sets a target.

  • Nobody has reconciled it

Square → Pinterest · diagnose

Diagnostic order — Square → Pinterest

  1. 01

    Count transactions carrying the epik click identifier

  2. 02

    Follow one real conversion end to end

  3. 03

    Split Square revenue by channel before anything else

    Online versus in-person. Every subsequent number depends on that split, and blending them makes both unreadable.

  4. 04

    Check the event delivery and match reporting in Pinterest Ads Manager

    Not the API response code. A 200 means Pinterest accepted the payload, not that it matched it to a click.

  5. 05

    Read the match rate, not the success message

    Pinterest Ads Manager reports events received and their match status. A successful API call is not a matched conversion — reconcile Pinterest's reported conversions against your own records for the same window and expect a structural gap from the save-then-buy delay.

Square → Pinterest · prove

How it gets proven — Square → Pinterest

Source of truth

Square's transaction list, split by channel — online and in-person are different questions.

  • The epik click identifier confirmed present on a live transaction.
  • Deduplication confirmed on a real conversion, and the attribution window your reporting uses stated explicitly.
  • The in-person join rate measured and stated as a number before any coverage claim is made.

Square → Pinterest · free audit

What we check in the free audit

  • Count transactions carrying the epik click identifier
  • Follow one real conversion end to end
  • Split Square revenue by channel before anything else
  • Check the event delivery and match reporting in Pinterest Ads Manager
  • Read the match rate, not the success message

Checked against

Square's transaction list, split by channel — online and in-person are different questions.

Get my free conversion tracking audit

Free30 minutesNo obligation

Square → Pinterest · when not to buy

When you don't need this — Square → Pinterest

  • Measure identifier coverage yourself first — pull your last hundred transactions and count how many carry the epik click identifier.
  • If nearly all your revenue is in person with no appointments and no identified customers, there is very little here to attribute and we will say so rather than build a bridge to nothing.
  • If Pinterest is a small test line on your media plan, the Conversions API is more work than the signal is worth this quarter.

Square → Pinterest · what we deliver

What gets built — Square → Pinterest

  • Identifier capture into Square

    Capture the click identifier and carry it into Square Online checkout, and for in-person work use an appointment booking as the bridge so the eventual payment can be joined through the customer record.

  • Event source: the Square payment webhook

    Subscribe to payment and order events and send from your server. This covers online orders cleanly, and covers in-person payments only for the share you can join to an identity.

  • Dispatch to Pinterest

    Server events to the Pinterest Conversions API with the click identifier, hashed customer data and a matched event_id.

  • Reversals where they exist

    Square exposes refunds clearly, and in hospitality and services voids and comps are frequent enough that wiring the reversal matters.

Written guarantee

95%+ tracking accuracy

Measured against Square's transaction list, split by channel — online and in-person are different questions.. Miss it and we keep working at no cost.

Get my free conversion tracking audit

From $400 · See packages

FAQ

Square → Pinterest questions, answered

Check Square Online's current marketing integrations. If it is not built in, you will need a custom setup for the checkout event.

More on Square → Pinterest

Free · 30 min

Get Square and Pinterest joined properly

Book the free call WhatsApp

Free30 minutesNo obligation