Skip to main content

How does the PayPal integration work?

Learn about Pirate Ship's PayPal integration and how you can connect your PayPal account to automatically import your orders

Pirate Ship's PayPal integration makes it easy to import your orders from PayPal and create shipping labels for them 🎉 Here's how the integration works:

Connecting your PayPal account

You can connect your PayPal account by heading to Settings > Integrations, clicking "Connect New Source," selecting PayPal, and following the prompts.

See this screenshot for an example of how that looks:

Integration settings

By default, Pirate Ship imports orders with the Shipping Status "Unshipped". However, you have the option to import orders with any shipment status, including:

  • Unshipped

  • Shipped

  • Not Shippable

When you ship an order that you imported, Pirate Ship automatically marks the order's Shipping Status as "Shipped" in PayPal and the tracking number will be attached 👍

Checkbox settings

When you go into your PayPal Integration Settings in Pirate Ship, you'll see that the line "Import orders without line items" is checked.

This is selected by default because it's sort of a "catch-all" measure for your PayPal orders, specifically those that don't include line items in PayPal but still need to be shipped.

Here's how that looks in your Integration Settings:

You may notice a slower import speed if you have a large number of orders to import. If you have a smaller number of orders (like 5, 20, etc). you probably won't notice it at all.

On the other hand, if you have 1,000 or more "Unshipped" orders to bring in, you may need to take up a quick hobby while the Import Grid loads 😅 You can always chat with us to hear some pirate jokes while you wait!

Tracking Emails

After connecting your PayPal account, you can choose to enable Pirate Ship's tracking emails in your Integration Settings for any orders you buy labels for.

  • We can't tell PayPal to not send its own tracking email, so we don't recommend using Pirate Ship's emails since your customers will receive two tracking emails: one from us, and one from PayPal 🙈

Adding Rubber Stamps

If you'd like to add information to labels such as order items, you can map information from PayPal to appear in your labels' Rubber Stamps field.

  • To do that, go to Settings > Integrations.

  • From there, click "Edit" next to your PayPal integration and then near the bottom "Edit Rubber Stamps" to assign data from PayPal to Rubber Stamps 👌

Here's how that looks:

Refunding labels

If you refund a label you purchased through the PayPal integration, the order will reappear in your Import Grid and automatically be marked as "Unshipped" again in PayPal.

Importing orders with different weights from PayPal

If your PayPal orders contain different items, you can use Pirate Ship's Override feature to import the weights of your orders. This will also import each order's insurance value and customs information for your international orders.

  • To do this, go to the Import page in Pirate Ship and select the orders you want to ship. Keep in mind that they don't all need to be the same weight, but they do need to all use the same packaging type and packaging dimensions in order for the feature to work.

  • After selecting the PayPal orders you want to ship and clicking Get Rates, check the "Override Package Details with Imported Data" checkbox on the next page to enable the Override feature.

PayPay archives orders older than 90 days

PayPal archives orders that haven't been fulfilled once they are 90 days old. Once an order is archived in PayPal, it won't import into Pirate Ship.

When this occurs, you will need to create labels for those orders manually. Once you do, you can copy the tracking information back to your archived order in PayPal.

Related resources

Did this answer your question?