When a customer pays with Afterpay, Shopify records the sale — but the Afterpay order ID often never gets saved onto the Shopify order itself. That single missing field quietly causes hours of manual reconciliation work every month: your finance team cross-referencing spreadsheets, support staff jumping between portals, and accountants guessing which Afterpay payout maps to which order.
This guide covers how the Snapper Apps Afterpay Order ID Update app fixes this permanently, and walks you through every step from installation to verification.
Why Afterpay order IDs go missing
Afterpay processes payments on its own infrastructure and sends a confirmation webhook back to Shopify. In most configurations, Shopify records the order as "paid via Afterpay" but doesn't store the underlying Afterpay order ID — it only stores the payment gateway name.
This means your Shopify order looks complete but is missing the key that ties it to the Afterpay payout report. The result:
- Finance can't match Shopify orders to Afterpay settlement files
- Customer service can't quickly locate a transaction during a dispute
- Month-end reconciliation requires manual side-by-side comparison of two systems
- Any chargeback investigation starts from scratch
Worth knowing: This isn't a bug in Shopify or Afterpay — it's a gap in how the two systems connect by default. It requires a dedicated sync layer to bridge them reliably.
What gets written
The Afterpay Order ID Update app does exactly one thing — it adds the Afterpay order ID as a tag or metafield on the matching Shopify order:
- Order tag — an
afterpay-id:AP-88423-style tag you can search and filter on in the Shopify admin - Order metafield — the same Afterpay order ID stored as a structured metafield that other systems can read
That is the whole job. It does not change payment status, customer details, line items, or any other order data — it only adds the order ID as a tag or metafield, using Shopify's official API. No theme modifications, no script injection, no fragile workarounds.
Step-by-step setup
The full setup takes under 10 minutes. Here's exactly what to do:
Contact us for app installation
Search for Snapper Afterpay Order ID Update in the Shopify App Store, or click the Install link on the app page. Click Install app and approve the permissions.
Connect your Afterpay account
In the app dashboard, go to Settings → Afterpay Connection and enter your Afterpay API credentials. You'll find these in your Afterpay merchant portal under Integrations → API Keys.
Choose tag, metafield, or both
Under Settings → Output, choose how the Afterpay order ID is stored on the Shopify order, then set:
- Auto-sync new orders — recommended on. Every new Afterpay order is matched automatically.
- Historical sync — set a start date to backfill the order ID onto past orders.
- Email alerts — add an email to be notified of auth failures or sync errors.
Run the connection test, then save
Click Test Connection — the app will verify your Afterpay credentials and confirm access. Once the test passes, click Save Settings. Auto-sync is now active.
Pro tip: Run the historical backfill before going live with new-order sync. This gives you a complete, gap-free dataset from day one and makes your first reconciliation run much cleaner.
Tag, metafield, or both
The app stores the Afterpay order ID on the Shopify order in whichever form suits how your team works. Choose one or both.
Order tag
A tag such as afterpay-id:AP-88423 is added to the order. Tags are searchable and filterable right in the Shopify admin, so ops and support can find an order by its Afterpay reference in seconds.
Metafield
The Afterpay order ID is also available as a structured order metafield — the reliable way for other systems that read your Shopify orders to pick up the reference programmatically.
One job, on purpose: the app only adds the Afterpay order ID as a tag or metafield. Keeping the scope this narrow is what makes it fast, safe, and predictable — there is nothing else it can get wrong.
Verifying your sync is working
After saving your settings, here's how to confirm everything is running correctly:
- Open any recent Shopify order that was paid via Afterpay
- Check the order's tags (or metafields) — the Afterpay order ID (e.g.
AP-88423) should be present - In the app dashboard, go to Activity Logs and confirm a "Successful sync" entry exists for that order
If an order shows as Pending or Failed, check the Logs tab for the specific error. The most common causes are an expired Afterpay API token or a time-mismatch between order and payment timestamps for historical orders.
Authentication expiry: Afterpay API credentials can expire. Enable email alerts in settings so you're notified before an expiry causes sync failures. The app will queue failed orders and retry automatically once credentials are refreshed.
Multi-store setup
If you're managing multiple Shopify stores, the app supports each store independently. Install on each store separately and configure its own Afterpay credentials and tag templates. All stores are visible in your Snapper Apps account under Stores.
For agencies managing client stores, you can use one Snapper Apps account to oversee all installations — each store's logs, sync status, and settings are kept entirely separate.
Summary
A missing Afterpay order ID doesn't have to be a permanent operational cost. With Snapper Apps Afterpay Order ID Update installed, every Shopify order — past and future — carries its Afterpay order ID as a tag or metafield. Your finance team reconciles faster, your support team resolves disputes faster, and your operations team stops manually cross-referencing two systems.
The whole setup takes under 10 minutes. If you run into any issues, our support team is available via the contact page.