Merchant Accounts

Overview

To print labels for your shippers, you must add them as merchants under your developer account. When you add a merchant, the merchant receives a unique Shipper ID that identifies the merchant during transaction requests.

The PB Ecommerce APIs support two models for handling a merchant’s postage payments. Depending on the payment model you choose, either a merchant pays for postage directly by setting up an individual PB Postage Account with Pitney Bowes or you pay postage on behalf of the merchant by setting up a Bulk Postage Account with Pitney Bowes and billing the merchant separately.

When you add merchants, they have access to print USPS® labels through PB Expedited and USPS PMOD. The APIs integrate with other carriers as well, and once a merchant enrolls with your developer account, you can add other carriers to the merchant’s account. For available carriers and onboarding instructions, see the carrier reference pages.

Merchant Enrollment Models

The APIs provide the following ways to add merchants to your developer account:

Enrollment Model


API

Description

Individual Postage Account

Authorize a Merchant

Merchants sign up for their merchant accounts through Merchant Portal by using a Merchant Portal URL that is specific to your developer account. During signup, a merchant specifies a payment method and creates a PB Postage Account. The Merchant Portal handles all of the merchant’s payment details.

To implement this approach do the following:

  1. Provide a custom signup URL.

  2. Once a merchant signs up, retrieve the merchant’s Shipper ID.

Bulk Postage Account

Register a Merchant

You manage postage funds on behalf of all your merchants through a Bulk PB Postage Account, also called simply Bulk Postage Account. To provide a merchant with a PB Shipper ID, you register the merchant with Pitney Bowes using the Register a Merchant API.

To set up a Bulk Postage Account, please contact Client Support at ClientSupportTechServices@pb.com.

Shipper ID

Every merchant added to your developer account receives a unique Shipper ID. You use the Shipper ID to identify a merchant when requesting transactions. You can retrieve a merchant’s Shipper ID using the Get Merchant Accounts API, which returns the returned Merchant Object. The merchant’s Shipper ID is the value found in the postalReportingNumber field of the Merchant Object.

If the merchant also has an individual PB Postage Account, the account number is the value found in the Merchant Object’s paymentAccountNumber field.

Note

 

  • The merchant’s Shipper ID is found in the postalReportingNumber field.

  • The merchant’s PB Postage Account number is found in the paymentAccountNumber field.

Payment Methods

Pitney Bowes offers the following payment methods to fund PB Postage Accounts:

Auto Refill

By default, a PB Postage Account is set up to automatically refill when the balance falls falls below a specified threshold. The refill amount and threshold are set when the account is created. You can change the refill settings at any time. You can also manually refill an account. If desired, you can disable automatic refill. For more information on funding PB Postage Accounts, see Payments FAQs.

Subscription Fee

Pitney Bowes has the option to charge a subscription fee to merchants who have their own PB Postage Accounts, which is the case for merchants onboarded through the Individual Postage Account enrollment model. For more information, please contact PaymentsAPISupport@pb.com.

Merchant Portal

Merchants who sign up for their own individual PB Postage Accounts have access to their accounts through the PB Merchant Portal. Pitney Bowes provides separate Merchant Portals for the Sandbox and Production environments:

Environment

Merchant Portal Link

Production

https://www.pbshippingmerchant.pitneybowes.com

Sandbox

https://developer.pbshippingmerchant.pitneybowes.com

FAQs

See the Merchants FAQs.

API Operations for Merchant Accounts

Use the following APIs to manage merchant accounts:

API


Method

Endpoint


Authorize a Merchant (Retrieve Credentials)

POST

/v1/developers/{developerId}/merchants/credentials

Register a Merchant in a Bulk Account

POST

/v2/developers/{developerId}/merchants/registration

View Merchant Accounts

GET

/v1/developers/{developerId}/merchants

Postage Management APIs

GET
POST
GET
POST

/v1/developers/{developerId}/merchants/{postalReportingNumber}/account-balance
/v1/developers/{developerId}/merchants/{postalReportingNumber}/account/fund
/v1/developers/{developerId}/merchants/{postalReportingNumber}/autorefillrule
/v1/developers/{developerId}/merchants/{postalReportingNumber}/autorefillrule

Add Carrier APIs

GET
POST

/v1/carrier/license-agreements?carrier={carrier}&originCountryCode={two-character-ISO-code}
/v1/developers/{developerId}/merchants/{postalReportingNumber}/carrier-accounts/register?carrier={carrier}

Deactivate a Merchant Account

To deactivate a merchant account, please contact our Payments API Support team at PaymentsAPISupport@pb.com or +1 855 393-8874.