ReturnMate logoReturnMate
Carriers integration

UPS + ReturnMate*

BetaThis integration is production-deployed and merchant-usable today. We're still expanding feature coverage and may iterate on behaviour as we learn from real usage. No service interruptions are expected.

UPS provides parallel global coverage to FedEx for ReturnMate merchants outside Australia. The integration uses OAuth2 with Basic Auth against UPS's REST API for ship, rate, track and pickup operations. Useful as a primary US carrier or as a redundant option alongside FedEx for international DG-aware routing and rate comparison. Currently in Beta — production-ready for US and Canada.

§ 01 — Capabilities

What the integration does.

  • OAuth2 with Basic Auth — UPS's standard auth pattern
  • Global Ship/Rate/Track/Pickup REST endpoints
  • Dangerous-goods support across major markets
  • Multi-package shipments and consolidated pickups
  • On-call pickup scheduling
  • SurePost and Ground Saver services for cost-sensitive returns
§ 02 — Use cases

How merchants use it.

US merchant primary carrier

For merchants where UPS is already the contract carrier (often through a corporate parent), ReturnMate uses UPS as the default for label generation, rating, and pickup booking. Branded labels, the same RMA timeline, no second tool.

Backup / rate-shop alongside FedEx

Many US merchants run both FedEx and UPS to play one off the other on rates. ReturnMate rate-shops at the customer portal, returning the cheaper option for each shipment based on weight, destination, and service level.

Canadian operations

UPS has strong Canadian coverage including UPS Standard cross-border. Useful as a primary or secondary option for Canadian merchants and US-Canada cross-border returns.

DG returns for non-AU markets

For DG returns originating in the US, Canada or EU, UPS is one of the two default DG-capable options (alongside FedEx). ReturnMate routes automatically based on SKU DG flags and origin market.

§ 03 — Setup

Connect UPS in minutes.

  1. 1

    Set up a UPS Developer account

    Register at developer.ups.com and create an app. Generate the Client ID and Client Secret needed for OAuth2 Basic Auth.

  2. 2

    Connect from ReturnMate

    Settings → Carriers → UPS. Paste Client ID and Secret. Run the OAuth flow. Tokens stored encrypted per shop with auto-refresh.

  3. 3

    Configure markets and service codes

    Pick which UPS services to use per market (UPS Ground, UPS Standard, etc.). Test with the UPS test environment before going live.

§ 04 — FAQ

Questions about UPS.

Should I use UPS or FedEx as my primary US carrier?

Depends on your account. Both have comparable network coverage and feature parity in the ReturnMate integration. The right choice is whichever you've negotiated better rates with. Many merchants run both and rate-shop per shipment.

Does UPS integration support Canada?

Yes. UPS has strong Canadian coverage and the integration handles Canadian domestic and US-Canada cross-border movements. Customs documentation generates as needed.

When is UPS coming out of Beta?

Beta status reflects ongoing feature expansion (advanced rate optimisation, scheduled pickup refinements, additional service codes), not stability concerns. The integration is production-deployed today. Exit-Beta target depends on field feedback from merchants currently using it; we'll move the badge once feature surface is at parity with the AU carriers.

Ready to connect UPS?

14-day free trial. No credit card required. Billed through Shopify.