How to Sync WooCommerce Tracking to PayPal and Stripe

You fulfil an order, add the tracking number, and move on. But your payment gateway still shows that transaction as shipped with no proof. When a customer opens a dispute, PayPal and Stripe ask you to produce tracking evidence, and if it is not already attached to the transaction, you are scrambling to upload it manually before a deadline you might miss.

Attaching that evidence by hand, on every order, is the task nobody keeps up with.

Advanced Shipment Tracking Pro (AST PRO), our WooCommerce shipment tracking plugin, can push tracking numbers, carrier names, and ship dates straight to the matching PayPal and Stripe transaction as soon as the order is marked Completed or Shipped. No manual uploads, no dispute-deadline panic, and stronger seller-protection coverage on both gateways.

This guide shows you how to connect AST PRO to PayPal and Stripe and control exactly which orders sync.

Why sync tracking to your payment gateway

Both PayPal and Stripe reward sellers who attach tracking to transactions. PayPal uses it for Seller Protection eligibility and resolves many disputes automatically once valid tracking is on file. Stripe stores it in payment metadata, which strengthens your evidence when you respond to a chargeback. Doing this by hand across every order is the part nobody keeps up with, so automating it is where the value sits.

How to set up PayPal tracking sync

1. Open the PayPal Tracking section
   Go to WooCommerce → Shipment Tracking, then open the PayPal Tracking tab from the settings sidebar. This is where every option below lives.
2. Get your PayPal REST API credentials
   You will need a Client ID and Client Secret from a REST API app in your PayPal Developer dashboard. Create an app under the live account you take payments with, then copy both values.
3. Enter your Client ID and Client Secret
   Paste them into the PayPal API Client ID and PayPal API Client Secret fields. These authorise AST PRO to write tracking data to your PayPal transactions.
4. Decide on Sandbox mode
   Leave Enable PayPal Sandbox off for a live store. Only turn it on if you are testing with PayPal sandbox credentials, and remember to swap back to live keys before going live.
5. Choose which payment methods sync
   Use PayPal Payment Methods to pick the gateways that should push tracking to PayPal. Select only your PayPal-based methods, since syncing a non-PayPal order to PayPal does nothing useful.
6. Turn on the buyer notification (optional)
   Enable Send tracking email to the customer from PayPal if you want PayPal itself to email the buyer when tracking lands on their transaction. Leave it off if your store already sends its own tracking emails and you would rather not double up.
7. Enable PayPal Tracking and save
   Switch on Enable PayPal Tracking and save. Keep Enable log on so any sync errors get written to WooCommerce → Status → Logs for troubleshooting.

How to set up Stripe tracking sync

1. Open the Stripe Tracking section
   In WooCommerce → Shipment Tracking, open the Stripe Tracking tab. Stripe uses fewer fields than PayPal, so this is a quicker setup.
2. Get your Stripe API secret key
   Grab your secret key from your Stripe API keys dashboard. Use your live key for a live store.
3. Enter your Stripe API Client Secret
   Paste the key into the Stripe API Client Secret field. This lets AST PRO write tracking details into your Stripe payment metadata.
4. Choose which payment methods sync
   Under Stripe Payment Methods, select the gateways that should push tracking to Stripe. Restrict this to your Stripe-based methods so the sync only fires on relevant orders.
5. Enable Stripe Tracking and save
   Turn on Enable Stripe Tracking and save. Leave Enable log on so any API errors are recorded under WooCommerce → Status → Logs.

PayPal vs Stripe sync setup

Setting	PayPal	Stripe
Credentials needed	Client ID + Secret	Secret key only
Sandbox toggle	Yes	No
Payment method filter	Yes	Yes
Buyer email from gateway	Optional	Not available
Error logging	Yes	Yes

What happens after setup

Once enabled, every time you add tracking to an order, AST PRO sends the tracking number, carrier, and date to the matching PayPal or Stripe transaction automatically. Your dispute evidence builds itself in the background, and your Seller Protection coverage stays intact without another task on your fulfilment checklist. Because the carrier name travels with the tracking number, it is worth having carrier auto-detection set up first, so the right carrier reaches the gateway without anyone choosing it from a dropdown.

How to confirm the sync actually worked

The sync fires when an order is marked Completed or Shipped, not at the moment you type the tracking number in. If you add tracking to an order that is still Processing, nothing is sent until the status changes. That single detail accounts for most “it is not working” support tickets.

There are three places to check the result:

• The order notes. When tracking is sent, a note is written to the WooCommerce order recording what went out.
• The orders list. A PayPal Tracking or Stripe Tracking column shows a checkmark, or the tracking details, per order — the fastest way to spot a batch that did not sync.
• The logs. With Enable Log on, any API error lands in WooCommerce > Status > Logs with the order and the reason, usually a credential or a payment-method filter that excludes the gateway you used.

Removing tracking from an order works in reverse: the shipment record is cancelled at PayPal or Stripe, so a cancelled or reshipped order does not leave stale evidence attached to the transaction.

Proof of shipment is not proof of delivery

This is the part worth understanding before you rely on the sync for dispute protection. Sending a tracking number to a gateway proves you shipped. For an item not received claim, PayPal looks for proof that the parcel arrived — online, verifiable tracking showing a delivered status, with a recipient address matching the transaction. Shipment evidence alone is generally enough for unauthorised transaction claims, not for non-receipt.

That gap is what the TrackShip integration closes. With TrackShip connected, the shipment status is tracked through to delivery and the Delivered status is pushed to the PayPal or Stripe transaction once the carrier confirms it — so the transaction carries the outcome, not just the dispatch.

For how disputes are actually decided once one is open, see how to reduce PayPal disputes with automatic tracking sync.

Frequently asked questions about PayPal and Stripe tracking sync

What credentials do I need to sync tracking to PayPal and Stripe?
PayPal needs a REST API Client ID and Client Secret from an app in your PayPal Developer dashboard, created under your live account. Stripe needs only your API secret key from the Stripe dashboard. Enter each into the matching AST PRO settings tab, using live keys for a live store, and the plugin can then write tracking to your transactions.

Can I sync tracking to both PayPal and Stripe at the same time?
Yes. AST PRO has separate PayPal Tracking and Stripe Tracking sections, and you can enable both. For each, you choose which payment methods sync, so a PayPal order pushes tracking to PayPal and a Stripe order pushes to Stripe automatically. Orders paid by other methods are left alone.

Should I use Sandbox mode?
Only for testing. Sandbox mode (PayPal only) lets you verify the setup with test credentials without touching live transactions. For a live store, leave Sandbox off and use your live API keys. If you do test in sandbox, remember to switch back to live keys before relying on the sync, a common setup mistake.

Does the tracking sync happen automatically after setup?
Yes. Once enabled, adding a tracking number to an order (manually, by CSV, by FTP, or via the API) automatically pushes the tracking number, carrier, and ship date to the matching PayPal or Stripe transaction. There is no separate export step; the dispute evidence attaches itself as part of your normal fulfilment.

What happens if the sync fails for an order?
With logging enabled, any API error is written to WooCommerce → Status → Logs, so you can see which order failed and why (usually a credential or payment-method-filter issue). Keeping Enable log on for both gateways is recommended, because it turns a silent failure into something you can find and fix rather than discovering it during a dispute.

Conclusion

Attaching tracking to every PayPal and Stripe transaction is the kind of task that protects real revenue but never gets done by hand. AST PRO automates it on both gateways at once: enter your credentials, pick the payment methods, and every fulfilled order builds its own dispute evidence in the background.