Stamps.com (US)

Stamps.com is a USPS postage reseller that grants access to all standard services offered by USPS, as well as additional international shipping options through GlobalPost.

US-based merchants can access Stamps.com services via ShipEngine Carriers. If you want to connect an additional Stamps.com account to ShipEngine, you can do so in your account dashboard.

Connect a Stamps.com Account to ShipEngine

To connect your Stamps.com account to ShipEngine:

  1. Click the United States Postal Service by Stamps.com tile.

    CONN_Carrier_USPStile_MRK.png
  2. Choose the option "Connect to an existing Stamps.com account", then click Continue setup.

    CONN_Stamps-ConnectionModal-Existing_MRK.png
  3. Enter your Stamps.com username and password, then click Continue setup.

  4. Review the details on the Confirmation screen, then click Connect.

You’re now ready to start creating USPS labels with your Stamps.com account!

Set Up Auto-Funding

Configure ShipEngine to automatically purchase postage when your Stamps.com account balance dips below a certain amount. Funds will be added from the credit card you have on file with Stamps.com.

  1. Click the vertical ellipsis for your Stamps.com account listed under the My Carrier Accounts section, then select Add Funds.

    CONN_Stamps-AddFunds_MRK.png
  2. Go to the Auto-Funding tab and toggle auto-funding On. Set the minimum balance before more postage is automatically purchased.

    CONN_SECarriers_AddFundsPU-Auto_MRK.png

    For example, if you wanted to purchase $100 any time your account balance is below $250, set the When balance falls below amount to ‘250’ and the Add the following amount to ‘100’. Then enter the maximum number of times ShipEngine should automatically purchase postage in a day next to Stop after this many times per day.

  3. Click the Save button.

Access Stamps.com Account Settings

You can access your Stamps.com account settings, reports, transaction history, and more from the ShipEngine dashboard.

Click the vertical ellipsis next to your connected Stamps.com account and select Edit to open the Edit Carrier window.

CONN_Stamps-Edit_MRK.png

Here, you will find the following options:

  1. Account Settings: Manage your Stamps.com account contact information, payment methods, plan level, and more.

  2. Online Reports Page: View your postage expenses, transactions, and account balance for a specific date range.

  3. Online SCAN Form Page: View and print your USPS SCAN Forms from Stamps.com.

  4. Reauthorize Stamps.com Account: Update your Stamps.com account password in ShipEngine.

  5. Refresh Services: ShipEngine returns rates for services enabled in your Stamps.com account. If you have recently had services added or removed, click Refresh Services to update the available services returned by ShipEngine.

CONN_Stamps_EditPU_MRK.png

Reset a Stamps.com Account Password

When you update your Stamps.com account password with Stamps.com, you will need to update the password in ShipEngine as well. Otherwise, you will encounter an error when attempting to use USPS services.

  1. Click the vertical ellipsis for your Stamps.com account listed under the My Carrier Accounts section, then select Edit.

    CONN_Stamps-Edit_MRK.png

    This will open the Edit Carrier window. Locate the Reauthorize Stamps.com Account section.

  2. Enter your Stamps.com password in the New Password and Confirm New Password fields.

    CONN_Stamps-Reauthorize_MRK.png
  3. Click the Update Password button.

Available Features for Stamps.com Integration

ShipEngine's integration with Stamps.com supports the following features:

Note

To meet USPS requirements, ShipEngine will always display postage for First Class Mail with the Large Envelope/Flat package type.

Additional Features

Feature

Description

Scheduled Pickups

After creating labels with Stamps.com services, you can schedule a carrier pickup in ShipEngine.

USPS SCAN Forms

Use ShipEngine to generate USPS SCAN forms for your Stamps.com shipping labels.

Global Advantage Program

The free Stamps.com account included with ShipEngine Carriers qualifies for GlobalPost's international consolidation service called the Global Advantage Program (GAP). See our GlobalPost integration guide for more details.

The carrier integration can be used to create domestic shipping labels.

The carrier integration can be used to create international shipping labels.

ShipEngine will submit international customs information electronically to the carrier.

The carrier integration can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Additional carrier insurance can be purchased through ShipEngine.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

The carrier integration can be used to create multi-package shipments, where multiple individual packages are linked together into a single shipment record with a master tracking number.

You can connect this carrier integration to ShipEngine multiple times using different account information, and choose which account will be used to create each shipment.

Create USPS Labels for Tubes or Rolls

This section explains how to ship tubes via USPS First Class and Priority services. For each service, the same weight and size restrictions that apply to packages also apply to tubes.

While ‘Tube’ is not currently an available package type in ShipEngine, Stamps.com recommends using ‘Package’ as the package type for these shipments. Enter the tube’s correct dimensions to ensure that label charges reflect the proper rate, whether you are using your own custom packaging or the USPS provided Dual-Use Priority and Priority Mail Express tubes.

Tip

Reference the USPS 201e Quick Service Guide to help determine the girth of a package.

USPS First Class Mail Tubes

For tubes, the height and width will be the same. USPS determines the rate by the weight of the package.

Max Weight

15.99 oz

Max Dimensions

(L) 22" x (H) 18" x (W) 15"

USPS Priority Mail Tubes

Priority Mail is zone-based pricing. That means for certain zip codes you will have to enter the dimensions of your tube to obtain the correct rate.

Entering dimensions is always recommended to ensure your packages receive the correct rate from the postage provider. Incorrect dimensions can result in packages being returned, or rate adjustments applied to your postage provider account after shipping.

Max Weight

70lbs

Max Dimensions

Length + Girth < 108"

USPS Dual-Use Tubes

If you ship using the small or medium Priority Mail or Express tubes provided by the USPS, you will still select ‘Package’ for the package type and enter the dimensions for the tubes into ShipEngine.

Additional Details about the Stamps.com Integration

  • USPS pickups can only be scheduled for one day in advance. For example, if you schedule a pickup on the 5th, for the 7th, the pickup date scheduled by Stamps.com will be the 6th.

  • USPS does not support Signature or Adult Signature confirmation for shipments to international addresses.

  • USPS SCAN forms must be created before 9pm local time.

  • Label Messages are not available for international shipments or domestic First-Class Mail shipments using the Letter package type.

  • Due to the discounted rates you receive through ShipEngine , it's not possible to show the postage cost on Stamps.com shipping labels.

  • All Stamps.com shipping labels are prepaid. In order to receive a refund for unused postage, void the shipping label within 28 days of creating the label.

  • Stamps.com has a postage-purchase minimum of $10 for a single transaction.

  • Each Stamps.com account can hold up to a maximum of $10,000 in available funds.

  • To report a lost USPS shipment created via ShipEngine, you must file a claim with USPS.

  • Large Envelopes/Flats shipped via First-Class Mail are not eligible for tracking and will not include a barcode on the label.

Troubleshooting Tips for Stamps.com Integration

Here are some common issues, potential causes, and troubleshooting tips.

Issue

How to troubleshoot or resolve

Error when creating SCAN form: One or more of these packages have already been scanned by USPS

OR

Error: An unexpected error occurred while creating the SCAN form. The size necessary to buffer the XML content exceeded the buffer quota.

SCAN forms (also called End of Day forms) can only be closed for orders that were created on that date, for that date. You will not be able to close a SCAN form for shipments that have a ship date in the past. In this case, the packages must be individually scanned by USPS.

If you are trying to close your SCAN form for the current day: Log into your Stamps.com account and print the SCAN form from the Online SCAN Form Page.

Error when attempting to get rates or create labels: Authentication Failed

This error message will occur if you've updated the password for your Stamps.com account. It means that ShipEngine no longer has the proper password for your account and is unable to communicate successfully with Stamps.com.

To resolve this error, reauthorize your Stamps.com password in ShipEngine.

Error: Invalid SOAP message due to XML Schema validation failure.....The actual length is less than the MinLength value.

This error may occur when attempting to get a rate for an international shipments to a country that does not use postal codes.

Enter 00000 in the Ship To address Postal Code field to receive a rate and create the label successfully.

Error: First and Last Name, with two chars each or Full Name with two char First and Last Name or Company Name with two chars is required for both sender and recipient.

For international shipments, USPS requires a first name and last name of two characters each, separated by a space for all Ship From addresses.

Error: Account is set to closed plan

This means the connected account has been either closed or removed from the ShipStation Pro plan. To resolve, contact Stamps.com at 1 (855) 860-7867 and ask to have your Stamps.com account changed back to a ShipStation Pro plan.

Locked out of Stamps.com account

If you are locked out of your Stamps.com account or unable to purchase postage on your account, you must contact the Stamps.com Trust and Safety team for assistance at (866) 634-4708. They will verify and release your account.

Refunds for late Priority Mail Express shipments

You will need to contact Stamps.com directly to claim a refund for late delivery.

Email shippersupport@stamps.com with the tracking number(s) and created date(s) for the shipment(s). Stamps.com will evaluate the claim and respond within 24 hours.

Customs Forms for First-Class Mail International shipments

USPS requires all "Merchandise" shipped via First-Class Mail International to use the Package package type. The Large Envelope or Flat package type is only valid if the content type for the shipment is "Documents."

The carrier integration can be used to create domestic shipping labels.

The carrier integration can be used to create international shipping labels.

ShipEngine will submit international customs information electronically to the carrier.

The carrier integration can be used to create domestic return labels.

When an API call is made to the Rates endpoint, ShipEngine will return estimated shipping rates for the carrier based on the connected account information and shipment details.

Additional carrier insurance can be purchased through ShipEngine.

Shipping labels created for this carrier will include a tracking number that can be used to view the shipment status on the carrier's tracking website. Tracking may not be available for all shipping services.

Shipment manifests and End of Day documents are submitted electronically to the carrier by ShipEngine.

Shipment manifests and End of Day documents are generated as PDF files that can be printed along with shipping labels. Because these documents are not electronically submitted, physical copies must be provided to the carrier.

ShipEngine can print your brand logo on shipping labels from carriers that support this feature. Add your logo in the ShipEngine Dashboard.

ShipEngine can include additional information on a shipping label that is specified in the label request, if supported by the carrier.

The carrier integration can be used to create multi-package shipments, where multiple individual packages are linked together into a single shipment record with a master tracking number.

You can connect this carrier integration to ShipEngine multiple times using different account information, and choose which account will be used to create each shipment.