Provide a Signup URL¶
Summary¶
A signup URL directs a new merchant to your signup page on Merchant Portal. The merchant uses the URL to sign up for a merchant account that’s attached to your developer account. The signup URL you provide includes your developer ID and can include other custom information specific to the new merchant’s account. You provide signup URLs if you use the Individual Postage Account enrollment model, as described in the Merchant Enrollment Models table on the Merchant Accounts page.
Once the merchant signs up through the URL, you retrieve the merchant’s account information, including Shipper ID, by issuing the Merchant Authorization API.
Signup URL¶
The Production and Sandbox environments use different domains for the signup URL, but they use the same directory path and query parameters. The following are the signup URLs for the two environments:
Environment | Signup URL |
---|---|
Production | https://www.pbshippingmerchant.pitneybowes.com/home?developerID={ID}[&optional_parameters] |
Sandbox | https://developer.pbshippingmerchant.pitneybowes.com/home?developerID={ID}[&optional_parameters] |
Query Parameters¶
This section describes the required and optional query parameters for the signup URL:
Required Parameter for Developer ID¶
Parameter
|
Description |
---|---|
developerID |
Required. Your Pitney Bowes developer ID. To retrieve your developer ID, log into Developer Hub and click your username and select Profile. |
Example:
The following example shows the signup URL with the required developerID parameter:
https://www.pbshippingmerchant.pitneybowes.com/home?developerID=12341234
Optional Parameters for Referral Codes and Payment Methods¶
Parameter
|
Description |
---|---|
referral_code |
Optional. Attaches a referral code to the merchant that you can use
to identify who referred the merchant to your software. The referral code
can use up to 25 characters and can use alphanumeric characters,
underscores (_ ), hyphens (- ), and dots (. ). |
paymentMethod |
Optional. Specifies the list of payment methods the merchant can choose from to fund the PB Postage Account. By default, the merchant’s choices are credit card, PB Line of Credit, or ACH. You can optionally limit the choices by setting this parameter to one of the following:
|
Examples:
The following example URL specifies a referral code of “offer123” and specifies the LOC_ACH payment method:
https://www.pbshippingmerchant.pitneybowes.com/home?developerID=12341234&referral_code=offer123&paymentMethod=LOC_ACH
The following example URL specifies the ACHOnly payment method:
https://www.pbshippingmerchant.pitneybowes.com/home?developerID=12341234&paymentMethod=ACHOnly