Merchant Returns API

The Returns APIs allow merchants that have signed up for the Scan Based Payment service access to the online serices of the Unites States Postal Service (USPS).

Who is the Merchant Returns API for?

Parcels

Parcels

Software Developer

Software Developer

Latest Updates

Description

The API allows merchants to directly offer merchant-funded USPS return labels from their own websites. The Domestic Returns API offers labels of three different sizes (4x4, 4x6, 3x6) in either PDF or TIF formats for customer convenience. The return labels also each have an Intelligent Mail Package Barcode (IMpb) that can be tracked on USPS.com.

Important Note: In order to begin using the API, you must first become a registered user with the assistance of a USPS administrator (see contact information below).
 

Featured Resources

User Guides
07/02/2024
Domestic Merchant Returns API: User Guide

This user guide provides examples of XML transactions to the USPS Merchant Returns web service and guidance for installation.

Related Products

Intelligent Mail® Package Barcode (IMpb)

The Intelligent Mail Package Barcode (IMpb) provides the best commercial prices with the largest discount available, piece-level tracking information at no additional charge for most products, and access to new products, services, and enhanced features. The addition of two (2) supplemental IMmb’s to the existing IMpb on a USPS shipping label results in enhanced package visibility with less mail rework.

Contact

For more information on the Merchant Returns API, contact support at Merchant.Returns.Support@usps.gov.