The Home page shows three live counters, all measured on the UTC day.

• Today Labels

  How many labels you have generated since 00:00 UTC today.

• Yesterday Labels

  Total for the previous UTC day.

• Total Labels

  Every label your account has ever generated.

Counters use UTC, not your local timezone, so they roll over at the same moment for everyone - but the page itself does not print the UTC date, so if your local day is ahead of or behind UTC, "Today" will not match your own calendar day. The More info links open Orders History with no filters applied; set the date range there yourself to see the rows behind a counter.

Use this when you have one shipment to generate. It's the fastest path for individual orders.

1. 1
   Open Single Label

   Pick Single Label from the sidebar to start a one-off shipment.

2. 2
   Choose tracking series & label type

   Pick a Carrier, a Tracking Series (e.g. 9401, 9505) and a Label Type (e.g. Priority Mail, Ground Advantage). The Label Type dropdown shows each option's price, so you can see what a label costs before you fill anything else in. If a dropdown is empty, either your admin has not granted that access yet or the list has not loaded - reload the page once before asking.

3. 3
   Enter From and To addresses

   Enter the From address (your warehouse) and the To address (recipient). Required on both sides: name, address line 1, city, state and ZIP. Company, phone and address line 2 are optional. Address autocomplete suggests valid US addresses as you type, and you can save an address to reuse it on the next label.

4. 4
   Enter weight

   Enter Weight in pounds - the number you type is what gets printed on the label. Length, width, height and package description are optional and do not change the price. The price comes from the label type you picked, not from the weight or the zone; the amount shown next to the label type is what you will be charged.

5. 5
   Generate the label

   Click Generate Label. A confirmation appears first, quoting the exact amount that will be charged - nothing is deducted until you accept it. The PDF then opens for printing and is saved to Orders History. Tracking numbers are unique; the system prevents accidental re-use. If the button stays disabled, a required field is still empty or the tracking series / label type is not selected.

Generate up to thousands of labels in one batch from a CSV file.

1. 1
   Download the CSV template

   Open Bulk Upload (the page is titled Order Bulk CSV) and click Export File. The download is an Excel workbook, template.xlsx. You can upload it back as .xlsx, .xls or .csv - all three are accepted.

2. 2
   Fill in your shipments

   One row per shipment. Keep the template's header row exactly as it is - the column names are matched literally. Required per row: FromName, Street1From, CityFrom, StateFrom, PostalCodeFrom, ToName, Street1To, CityTo, StateTo, ZipTo and Weight.

3. 3
   Pick tracking series & label type

   In Step 1, choose the Tracking Series and Label Type that apply to all rows in this CSV. (One batch = one label type.)

4. 4
   Upload your CSV

   In Step 2, drag the file onto the upload zone or click Browse. Nothing is charged at this point.

5. 5
   Click Verify Data

   Verify Data is the next button you press - Generate Labels stays hidden until the file passes. Validation is all-or-nothing: if even one row fails, nothing can be generated. The first 20 problems are listed with their row numbers; fix them in the file, re-upload and verify again. When the file passes you get the row count and the estimated charge before anything is spent.

6. 6
   Generate Labels

   Click Generate Labels. Labels are produced in the background - you can leave the page and come back. Rows are processed in parallel, so they do not finish in file order.

7. 7
   Download the finished batch

   When it finishes, the batch appears in Download Batches. From the batch row you can take a combined PDF of every label (one file, ready to print), a ZIP of the individual PDFs, or an Excel tracking export. They are separate downloads, not one file.

CSV column reference

Every label you generate, single or batch, lands here.

• Search

  The box is labelled Search by ID, Name, Tracking… and matches on tracking number, sender/recipient name and address. Note that on large accounts the search runs on the server and then only matches tracking number and names - if an address search stops finding a row, narrow the date range first.

• Filter

  By date range and label type. There is no batch filter here - open Download Batches to work with a specific batch.

• Order Details

  Click any row to view the full address, weight, charge, and a button to re-download or reprint the label.

• Free re-downloads

  Re-downloading a label does not charge you again - you only pay when the label is first created.

• Select rows, then act on them

  Tick individual rows or use the per-page selector, then use Merge PDF (one print-ready file), Download ZIP (separate PDFs), Export Tracking (spreadsheet of tracking numbers) or Track Packages (current USPS status).

The Batches page lists every bulk upload you have ever processed.

• Batch summary

  Each row shows the label type, then a live count of Pending, Processing, Success and Fail against the batch Total, plus tracking status and the date it was added. The batch row does not show a total charge - open Balance for what was actually spent.

• Download combined PDF

  Each batch row offers View, Download combined PDF, Download ZIP, Export tracking (Excel) and Track all shipments. These are greyed out until at least one label in the batch has succeeded. You can also tick several batches and use Merge Selected Batches for one file across all of them.

• Re-downloads and failed rows

  Re-downloading a batch never charges you again. If some rows show under Fail, only the successful labels are included in the downloads - the failed rows were not charged, so re-upload just those rows as a new file. Batches stay available under your account's current retention policy; export anything you need to keep in your own records.

ShipHub uses a prepaid balance model.

1. 1
   Top up your own balance, any time

   Open Balance → Add Funds and pay with crypto (BTC, ETH or USDT). Nobody has to approve it - the credit is automatic once the payment confirms on the blockchain, which is usually well inside an hour but depends on the network, not on us. The Add Funds screen shows the current minimum and any bonus offer that happens to be running.

   Prefer to pay another way? That route still works exactly as before - message support and an administrator credits your balance manually.

2. 1
   Your administrator credits your balance

   Ask your administrator to add funds to your account. Every credit appears under Balance in the sidebar the moment it lands.

3. 2
   Each label deducts postage

   Every generated label subtracts its postage cost from your balance.

4. 3
   Track every transaction

   The Balance page in the sidebar shows every credit and debit, with a running balance after each.

5. 4
   No partial charges

   If you run out of balance, label generation is blocked until balance is added - no partial charges are ever applied.

Pay for your ShipHub balance with crypto - even if you've never bought crypto before. This guide is written for shippers based in the United States.

Last reviewed: August 2026. Third-party app fees, limits and speeds change without notice - treat every number below as a starting point and confirm the current figure in the app before you commit.

1. What ShipHub accepts

You can top up with any of the four supported assets. Pick whichever you find easiest to buy.

2. Pick your buying app (US options)

These are the three apps most US users will already have. Pick one - you only need one. If you are opening an account for the first time, budget for identity and bank verification before you can buy; that step is on the app, not on us, and can take a few business days.

Other US options that work the same way: Robinhood (BTC, ETH - external transfers enabled), Binance.US (BTC, ETH, USDT on multiple networks - lower fees), Kraken (advanced users), PayPal / Venmo (BTC, ETH - withdrawals allowed but fees are high).

3. Walkthrough - Buying BTC with Cash App

1. 1
   Open Cash App → Bitcoin tab

   Tap the Bitcoin (BTC) icon at the bottom of the home screen. First-time users will be asked for SSN + photo ID - verification usually takes <5 min.

2. 2
   Tap "Buy" → enter USD amount

   Enter the dollar amount you want to top up - the current minimum is shown on ShipHub's Add Funds screen. Cash App will deduct it from your linked debit card or Cash App balance. The BTC arrives in your Cash App wallet instantly.

3. 3
   Open ShipHub → Add Funds → Bitcoin

   In a second tab, go to ShipHub Balance → Add Funds (or the button on the dashboard balance card), pick BTC, enter the same USD amount, and press the pay button - it is labelled Pay with Crypto, and while a bonus offer is running it shows what you pay and what you get. A secure checkout page opens in a new tab with a one-time BTC address, a QR code and the exact BTC amount to send.

4. 4
   In Cash App: Bitcoin → Withdraw Bitcoin

   Back in Cash App, on the Bitcoin tab tap Withdraw Bitcoin → scan the QR code on the checkout page or paste the address from it. Enter the exact BTC amount the checkout page shows. Cash App's free Standard withdrawal has a minimum send amount (recently 100,000 sats / 0.001 BTC) - if your top-up is under that, use Instant, which charges a fee shown in the app, or use an app without a withdrawal floor. Confirm both figures in Cash App before you buy.

5. 5
   Confirm - your balance auto-credits

   Confirm the withdrawal. Once Bitcoin confirms on-chain (usually 10–30 minutes), ShipHub credits your balance automatically. You'll see the new amount on the dashboard.

4. Walkthrough - Buying BTC, ETH or USDT with Coinbase

1. 1
   Sign up at coinbase.com and verify ID

   Standard US KYC - SSN, photo ID, and a selfie. Verification is usually instant. Use the official Coinbase app or coinbase.com - beware of lookalikes.

2. 2
   Link a US payment method

   In Settings → Payment methods, link a bank (ACH - free but takes 1–3 days) or a debit card (instant, ~3.99% fee). Wires are also supported for larger top-ups.

3. 3
   Buy BTC, ETH or USDT

   Tap Buy, pick the asset and enter your USD amount. For USDT, Coinbase uses the Ethereum / ERC-20 network - match this on ShipHub (pick the USDT-ERC20 option).

4. 4
   Start the payment on ShipHub

   On ShipHub Balance → Add Funds, pick the same coin/network you bought on Coinbase, enter the USD amount, and press Pay with Crypto. A checkout page opens in a new tab showing the deposit address, the network and the exact amount - copy the address from there. Note: addresses are one-time - never reuse an old one.

5. 5
   In Coinbase: Send → paste address

   Open the asset in Coinbase, tap Send, paste the address, and enter the exact amount ShipHub gave you. Coinbase shows the network - confirm it matches ShipHub. Tap Send.

6. 6
   Wait for confirmations

   Typical confirmation times when the networks are not congested: USDT-TRC20 about 1–3 minutes, ETH and USDT-ERC20 about 3–10 minutes, BTC about 10–30 minutes. Congestion can make any of these considerably longer. Once it confirms, ShipHub credits your balance automatically - there is no manual step.

5. Quick comparison - which US option is best for me?

6. Sending safely - 5-step checklist

Every successful crypto top-up follows these five rules. Skim them before you click Send.

1. 1
   Copy-paste - never type the address

   Never type an address by hand. Always copy it from ShipHub and paste it into your app, then check that the first and last few characters match what ShipHub shows. Many address formats are case-sensitive and a single wrong character means the funds are gone for good.

2. 2
   Match the network exactly

   ShipHub accepts BTC on the Bitcoin mainnet and ETH on the Ethereum mainnet only - do not send over Lightning or an Ethereum layer-2, even though some apps offer those. USDT exists on several networks; pick the same one on both sides (TRC-20 ↔ TRC-20 or ERC-20 ↔ ERC-20). Send on any network ShipHub does not show and the funds are not recoverable.

3. 3
   Send the exact amount shown

   If the invoice expires before you send, generate a new one - exchange rates move and a stale invoice may underpay.

4. 4
   Test small the first time

   For your first transfer ever, top up the smallest amount Add Funds will accept, so you can prove the whole pipeline works before sending larger amounts.

5. 5
   Wait for confirmations - don't double-send

   Once you click Send, the network does the rest. ShipHub's dashboard shows a "Crypto payment pending" pill - your balance auto-credits as soon as the blockchain confirms. Don't send a second time.

7. FAQ

I sent USDT on the wrong network - can I recover it?

Usually no - funds sent on a network ShipHub does not accept are lost. Always match the network shown on the invoice. If you are unsure, use BTC on the Bitcoin mainnet, and check your app is not defaulting to Lightning.

How long until my balance is credited?

Typically USDT-TRC20 1–3 minutes, ETH and USDT-ERC20 3–10 minutes, BTC 10–30 minutes - longer when the network is busy. ShipHub credits automatically, so you don't need to refresh or contact support unless it is still pending after an hour.

Why is my deposit address different each time?

Each top-up gets a unique one-time address for privacy and accounting. Never reuse an old address - generate a new one for every top-up.

What's the minimum top-up amount?

The current minimum is shown on the Add Funds screen - that screen is always the authority. Smaller amounts are rejected because network fees would eat too much of the deposit.

Can I use PayPal or Venmo to buy crypto?

Yes - both let US users buy BTC and ETH and now allow external transfers. Fees are higher than Coinbase/Strike, but the convenience is hard to beat if you already use them.

Does ShipHub charge a fee on top-ups?

No. ShipHub credits the full invoiced amount. The blockchain itself charges a network fee to move the coins, which your app deducts on its side - it is usually small, but it depends on the asset and how busy the network is, so check the fee your app quotes before you confirm.

The payment shows "partially paid" - what now?

Less than the invoice amount arrived - usually because the exchange rate moved between the quote and the send, or a fee was taken off the top. A partially paid invoice does not credit automatically. Send the shortfall against the same invoice while it is still open, or message support with the asset, amount, network and time and it can be settled by hand.

Tax implications?

The IRS treats digital assets as property, so disposing of crypto, including spending it, can create a reportable gain or loss, however small. Whether your app issues you a tax form depends on the app and on the rules for that year, and you may still have to report even if you never receive one. See the IRS guidance on digital asset transactions, and talk to a tax professional about your own situation. Nothing here is tax advice.

I'm not in the US - does this still work?

Yes. The technical steps are identical worldwide; only the recommended apps change. Use Coinbase (90+ countries), Binance (most of the world), Kraken (EU + UK + US), or any local exchange. The ShipHub side is the same.

If you already manage orders in ShipStation or Veeqo, you can pull them straight into ShipHub instead of typing addresses by hand.

1. 1
   Open Settings → Integrations

   Click the gear icon at the top right.

2. 2
   Toggle ShipStation or Veeqo

   A new tab will appear in the sidebar once enabled.

3. 3
   Connect your account

   Click the new sidebar tab and connect. You'll be asked for an API key the first time: in ShipStation it is under Settings → Account → API Settings, in Veeqo under Settings → Users & Roles → API keys. Give it read access to orders and write access to shipments - anything less and imports or tracking sync will fail. The key is stored against your ShipHub account only; you can replace or remove it later from Settings → Integrations.

4. 4
   Set your From Address

   Your warehouse address. It is reused as the sender for every imported order, so a typo here goes onto every label - check it before the first batch. You can change it any time from the same screen; existing labels are not affected.

5. 5
   Generate & sync

   Pick orders from the imported list and generate labels. Tracking numbers are pushed back to ShipStation/Veeqo automatically when the option is on. Two confirmations are worth reading rather than clicking through: one warns that a selected order already has a label and generating again will charge you again, and one warns that an order has no weight and will be generated at 1 lb. If the push-back fails, the label is still created and charged - the tracking number is in Orders History and can be copied across by hand.

For developers: ShipHub exposes a REST API so you can generate labels from your own software. The API page is the source of truth - it renders live examples using your own account's host and key, so it cannot drift out of date. Everything below is a summary of it.

Open API documentation

• Live examples & your key

  The API page shows your key, the exact host for your account, and copy-paste-ready examples. It also has Renew Key - renewing revokes the old key immediately, so swap it in your integration first.

• API key auth

  Send your key in the X-API-Key header - not as a Bearer token. Authorization: Bearer … is only for the portal's own session token and will return 401 with an API key. Treat the key like a password.

• Endpoints

  GET /api/user/services to list the label type + tracking series combinations you can use, POST /api/user/create-order to create one label, and GET /api/user/order/{trackingId} to fetch it again. Those three accept an API key. The portal's own bulk upload is not exposed to API keys - loop create-order instead.

• Shared balance & limits

  API calls deduct from the same balance as the portal. Create-order allows up to 500 requests per minute per account, and all endpoints share 5,000 requests per 15 minutes per IP. A 429 response carries a retryAfter value in seconds. The API page lists the full 400/401/402/403/404/429 error table.

Quick example - create one label (curl)

The host below is the current production one. Your account's exact host is printed on the API page - copy it from there rather than from here.

curl -X POST "https://shiphub-production.up.railway.app/api/user/create-order" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label_type": "rollo_priority_mail",
    "tracking_prefix": "9401",
    "fromName": "John Doe",
    "fromAddress": "123 Main Street",
    "fromCity": "Los Angeles",
    "fromState": "CA",
    "fromZip": "90001",
    "toName": "Jane Smith",
    "toAddress": "456 Elm Street",
    "toCity": "New York",
    "toState": "NY",
    "toZip": "10001",
    "weight": 2
  }'

Quick example - JavaScript (fetch)

const res = await fetch(HOST + '/api/user/create-order', {
  method: 'POST',
  headers: {
    'X-API-Key': API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    label_type: 'rollo_priority_mail',
    tracking_prefix: '9401',
    fromName: 'John Doe',
    fromAddress: '123 Main Street',
    fromCity: 'Los Angeles',
    fromState: 'CA',
    fromZip: '90001',
    toName: 'Jane Smith',
    toAddress: '456 Elm Street',
    toCity: 'New York',
    toState: 'NY',
    toZip: '10001',
    weight: 2
  })
});

const { data } = await res.json();
// data.tracking_id     -> "9401123456789012345678"
// data.pdf             -> download URL for the label PDF
// data.barcodes_status -> "complete" | "partial" | "unavailable"

Open Settings via the gear icon at the top right of any page.

• Integrations tab

  Show or hide the ShipStation and Veeqo sidebar tabs, and disconnect an account you no longer want linked.

• Security tab

  Change your password: enter your current one, then the new one twice. Minimum 8 characters with a mix of letters and numbers.

• Your API key

  The key on the API page spends the same balance as the portal, so treat it like a password: never paste it into a browser console, a shared document or client-side code. If it may have leaked, use Renew Key - the old key stops working the moment you do, so update your integration in the same sitting.

"Insufficient balance" error

Your balance is below the cost of the label(s) you tried to generate. You can top up yourself from Balance → Add Funds - no admin approval needed. Alternatively remove some rows from your CSV and generate the rest.

Tracking series dropdown is empty

Your account has not been granted access to any tracking series. Contact your admin.

Label type dropdown is empty after picking a tracking series

The label types tied to that tracking series aren't enabled for your account. Pick a different series, or ask your admin to add access.

"Duplicate tracking number" error

The system blocks reuse of any tracking number that has ever been generated. This protects you from USPS rejecting the package. Just retry - the next number in the series will be used automatically.

Batch stuck on "Processing"

Refresh the page. The batch processor reconnects and resumes where it left off. Each row is keyed by its position in the file, so the same row cannot be charged twice. If rows end up under Fail, those were not charged - re-upload just those rows as a new file.

Generated label PDF won't open

Disable popup blockers for this site, or use the re-download button in Orders History. Some browsers block auto-opened PDFs by default.

Address autocomplete not suggesting

Autocomplete only works for US addresses. Type at least the first 3 characters of the street.

I generated a label by mistake - can I get a refund?

Open Orders History, find the label and use the Refund button on that row. The credit goes back to your ShipHub balance, not to your card or wallet. A label can be refunded once, only within 30 days of purchase, and only if it has not already been refunded or voided. There is also a rolling cap - total refunds are limited to a small percentage of what you have topped up in the last 30 days, and the dialog shows how much of that you have left. If the label is outside those rules, contact support with the tracking number and an administrator can look at it.

My crypto top-up says "pending" or "confirming"

The payment has been seen but the blockchain has not finished confirming it. Wait - do not send a second payment. The balance credits itself when it confirms.

My payment invoice expired before I sent it

Start a new top-up. Do not pay an expired invoice's address: the exchange rate it was quoted at has moved, so the amount would no longer match.

I sent less than the invoice, or used the wrong network

Neither credits automatically. Contact support with the asset, the amount, the network and the time you sent it, and it can be traced.

Verify Data failed and Generate Labels never appeared

That is intentional - validation is all-or-nothing. Fix every listed row (only the first 20 are shown), re-upload the file and verify again. The two most common causes are a renamed header and a weight value meant as ounces: the sender ZIP column is PostalCodeFrom while the recipient one is ZipTo, and a bare number in Weight is read as pounds.

The API returns 401, 402 or 429

401 - the key is missing, revoked, or sent as Authorization: Bearer instead of the X-API-Key header. 402 - not enough balance; the message states what was required and what you had. 429 - rate limited; wait the number of seconds in retryAfter and retry.

An imported ShipStation/Veeqo order did not get its tracking number back

The label itself was still created and charged. Copy the tracking number from Orders History into the order manually, then check that the integration is still connected under Settings → Integrations.

My balance did not update after a label was generated

Reload the page - the balance pill reads a cached value. If it is still wrong, check the Balance page: every charge is listed there with a running balance, and that page is the record.

Your administrator also has your full account history, including balance, charges and every label you have generated, and can resolve most account questions directly.