Description
Features
- Real-time Amazon Shipping rate display at checkout — customers see live carrier rates
- Label purchasing directly from your store admin — no third-party portal required
- Full Amazon Shipping SP-API integration (2024 API)
- Supports domestic and cross-border shipments
- Returns label generation built in
- Shipment tracking synced back to your order
- Multi-package shipment support
- Configurable rate markup / discount rules
- 90-day support included after purchase
Platform Requirements
- BigCommerce Standard, Plus, Pro, or Enterprise plan
- Real-Time Shipping Quotes enabled on your BigCommerce plan
- Amazon Shipping enabled on your seller account
- API access (BigCommerce V2/V3 API credentials required)
Prerequisites
- Active Amazon Seller Central account with Amazon Logistics / Amazon Shipping enabled — See our merchant signup guide
- Amazon SP-API credentials: Client ID, Client Secret, Refresh Token, Seller ID, Marketplace ID
- HTTPS store (required by Amazon SP-API OAuth)
What is included
- Module/plugin zip file (download immediately after purchase)
- Installation & configuration documentation (PDF)
- User guide (PDF)
- 90 days of email support from the Harper development team
New to Amazon Shipping? See our step-by-step Amazon Logistics merchant signup guide before purchasing.
Installation Notes
- Download the module zip file from your WooCommerce account → Downloads immediately after purchase.
- Log in to your store admin panel.
- Upload and install the module using your platform’s module/plugin manager.
- Navigate to the module configuration screen (path varies by platform — see Configuration section below).
- Enter your Amazon SP-API credentials and save.
- Enable at least one shipping service (e.g. Amazon Shipping Ground, Amazon Shipping Priority).
- Place a test order on your storefront to confirm rates appear at checkout.
- Purchase a test label from the order admin screen to confirm label generation works.
Need help? The Module + Installation option includes remote installation by our team. Alternatively, email [email protected].
BigCommerce-Specific Installation
The BigCommerce module runs as a hosted microservice that you connect to your store. Setup involves three parts:
- Deploy the service — the zip includes a Node.js microservice. Deploy to your server or a cloud provider (AWS Lambda, DigitalOcean App Platform, etc.). Full deployment instructions are in the documentation.
- Connect BigCommerce — in BigCommerce Admin, go to Store Setup → Shipping → Real-Time Shipping Quotes and add the Harper Amazon Shipping endpoint URL.
- Configure credentials — set your SP-API credentials and BigCommerce API keys in the service environment variables (a
.env.exampleis included). - Test with a checkout flow on your storefront.
Enterprise architecture and hosting setup assistance is available — contact [email protected].
Configuration Guide
Step 1 — SP-API Credentials
In the module settings panel enter:
| Field | Where to find it |
|---|---|
| Client ID | Seller Central → Apps & Services → Develop Apps → your app |
| Client Secret | Same app screen as above |
| Refresh Token | Generated during OAuth authorization — see our signup guide |
| Seller ID | Seller Central → Account Info → Merchant Token |
| Marketplace ID | CA: A2EUQ1WTGCTBG2 | US: ATVPDKIKX0DER |
Step 2 — Shipping Services
Select which Amazon Shipping services to offer at checkout. Available services depend on your account level and origin address:
- Amazon Shipping Ground
- Amazon Shipping Standard
- Amazon Shipping Priority
- Amazon Shipping Overnight
Step 3 — Rate Rules (optional)
Apply a percentage or flat-dollar markup/discount to the Amazon rates before displaying them to customers. For example, set +10% to recover handling costs.
Step 4 — Ship-From Address
Confirm the ship-from address matches the address registered in your Amazon Shipping account. Mismatches can cause rate retrieval failures.
Step 5 — Test Mode
The module includes a sandbox/test mode. Enable it, complete a test checkout, then disable before going live. SP-API sandbox credentials are separate from live credentials — see Amazon’s developer documentation.
User Guide
Getting Rates at Checkout
Once configured, Amazon Shipping rates appear automatically alongside your other shipping methods at checkout. No customer action is required.
Purchasing a Shipping Label
- Open the order in your admin panel.
- Locate the Amazon Shipping meta box / tab.
- Select the service level, confirm package dimensions and weight.
- Click Purchase Label. The label PDF downloads immediately and the tracking number is written to the order.
Printing the Label
Print the downloaded PDF on a standard 4×6 thermal label printer or on letter-size paper. Affix the label to the outside of the package.
Tracking
The module writes the tracking number to the order automatically. If your theme or order notification emails display tracking numbers, they will appear there. You can also find tracking in the order admin meta box.
Returns
To generate a return label, open the order, navigate to the Amazon Shipping meta box, and click Create Return Label. The label is emailed directly to the customer and saved against the order.
Troubleshooting
- No rates at checkout — check your SP-API credentials, confirm Amazon Shipping is enabled on your seller account, and verify the ship-from address matches Amazon’s records.
- Label purchase fails — ensure the package dimensions and weight are within Amazon Shipping’s accepted limits for the selected service.
- Sandbox rates are $0 — expected behaviour in sandbox mode. Switch to live credentials for real rates.
For support, email [email protected] with your order number and a description of the issue.