Operational Shipping Guide
Complete technical and operational manual for configuring account security, quoting single or bulk parcels, settling invoices in Monero, and inducting thermal labels.
This manual covers the end-to-end operational lifecycle of an XMRShip parcel—from initial Tor Browser connection and PGP key binding through rate calculation, Monero settlement, label printing, and post-delivery data purging. Select any section or numbered step in the left-hand overview to jump directly to that procedure.
Account & Operational Security Setup
Configuring your environment, cryptographic two-factor authentication, and reusable sender profiles.
Step 1.1 Clearnet vs. Tor .onion Access
XMRShip is accessible via standard HTTPS on clearnet or through our v3 Tor hidden service (xmrshipawdb5exkh4rmn43cixzqf7ziwdm3ojuanfodul4ohz3vwpvyd.onion). When connecting over Tor, set Tor Browser's security level to Safest. All forms, dropdown menus, arithmetic anti-bot challenges, and inline SVG QR codes operate server-side without JavaScript.
Step 1.2 Binding Your PGP Public Key & Enabling 2FA
Navigate to Profile → PGP Public Key & Two-Factor Authentication and paste your ASCII-armored RSA or Ed25519 public key block (-----BEGIN PGP PUBLIC KEY BLOCK-----). The server encrypts a one-time verification token using GnuPG. Decrypt the message locally with gpg --decrypt, submit the plaintext code, and toggle PGP 2FA on. Subsequent logins require decrypting a fresh challenge within 10 minutes.
Step 1.3 Saved Address Book & Pre-Funded CAD Balance
Store frequently used return or recipient addresses in your Profile Address Book to populate shipment forms in one click. If you dispatch daily batches and want zero-wait checkout without waiting for Monero block confirmations on each parcel, contact support to enable your prepaid CAD balance ledger.
Single Parcel Rate Quoting & Creation
Entering sender/receiver coordinates, accurate parcel dimensions, and customs manifests.
Step 2.1 Origin & Consignee Address Formatting
Open New Shipment and select the origin country (CA or US). Ensure postal and ZIP codes match the selected state or province. Include a valid 10-digit telephone number for the recipient; tier-1 express carriers (Purolator, UPS, FedEx) require a phone field in their API schema even though they rarely call for standard residential drops.
Step 2.2 Accurate Weight & Optical Scanner ceil() Dimensions
Enter parcel weight in kilograms (kg) and exterior box dimensions in centimeters (L × W × H cm). Always measure the longest bulge of soft poly-mailers or taped cartons. XMRShip applies ceil($cm * 0.393701) when converting dimensions to inches so your rated volumetric weight matches carrier optical sorting tunnels.
Step 2.3 International & Cross-Border Customs Declarations
When the origin and destination countries differ (e.g., CA → US or US → GB), complete the Customs Declaration items block. Provide a specific commodity description (avoid vague terms like "gift" or "merchandise"), quantity, unit weight, declared value, and 6-to-10 digit Harmonized System (HS) tariff code.
Step 2.4 Selecting a Carrier Service & MPS Disambiguation
Click Calculate Rates to view live commercial options sorted by cost. When you select a service and generate the shipment, XMRShip automatically appends an 8-character UUID reference tag ((Ref: 42A74C4B)) to the consignee name and unit line so multiple packages sent on the same day are never merged into a Multi-Piece Shipment (MPS).
Bulk CSV Dispatch Workflow
Uploading up to 100 parcels per batch, background rate quoting, and single-archive label export.
Step 3.1 CSV Schema & 100-Row Batch Limits
Open Bulk Upload and download the canonical CSV template. Each file supports up to 100 rows per upload. Required columns include sender and receiver coordinates (name, street, city, province, postal_code, country, phone) and parcel metrics (weight, length, width, height).
Step 3.2 Asynchronous Rate Calculation & Batch Requoting
Upon CSV submission, rows enter calculating status while background workers query carrier rates. Once quoted, shipments transition to pending_payment with the lowest-cost service pre-selected, or you can use Batch Requote on your dashboard to switch selected parcels to a specific express carrier tier.
Step 3.3 Bulk Cart Checkout & Single-ZIP PDF Export
Select multiple pending_payment shipments—or click Pay All—to consolidate the entire batch into a single BTCPay Monero invoice or a single account balance deduction. Once all labels reach shipped status, click Download All Labels to receive a single ZIP archive containing all 4×6 PDF labels and export a CSV manifest of tracking numbers.
Invoice Settlement & Confirmations
Paying with Monero (Base + 5%), Account Balance (Base + 10%), and live price coverage verification.
Step 4.1 On-Chain Monero (XMR) Payment via BTCPay Server
On the invoice screen, scan the inline SVG QR code or copy the exact Monero subaddress and XMR amount into your wallet (Feather, Cake Wallet, Monero GUI/CLI). Ensure your wallet network fee is not subtracted from the invoice amount. Once our self-hosted node verifies standard block confirmations (typically 10–20 minutes), the webhook marks the shipment paid and queues label generation automatically.
Step 4.2 Instant CAD Account Balance & Card Settlement
If your account has a pre-funded CAD balance enabled, click Pay with Account Balance on the invoice screen to settle at Base + 10%. The deduction executes inside a locked database transaction and dispatches ProcessShipmentJob immediately without waiting for blockchain confirmations.
Step 4.3 Live Rate Coverage Verification (Slippage Guard)
During background label fulfillment, ProcessShipmentJob queries the carrier API with forceRefresh = true to confirm the live carrier rate has not increased beyond the settled invoice coverage before committing the purchase.
Label Printing, Drop-Off & Data Purging
Thermal 4×6 label output, physical carrier induction, tracking lookups, and archive deletion.
Step 5.1 Thermal 4×6 PDF Label Printing & Barcode Placement
Download your PDF shipping label from the Shipments dashboard. Labels are formatted natively at 4 × 6 inches for direct thermal printers (Zebra, Rollo, Brother) or standard letter paper at 100% scale. Affix the label flat onto the largest surface of the parcel; do not place reflective packing tape over the 1D/2D carrier barcodes.
Step 5.2 Carrier Drop-Off & Live Tracking Verification
Deposit the sealed parcel at any authorized carrier drop box, retail depot, or scheduled commercial pickup. You can monitor transit checkpoints directly inside XMRShip via the Tracking tab without visiting external carrier websites that track your IP or browser fingerprint.
Step 5.3 Archiving, Voiding & Permanent Record Purging
Once a parcel is delivered—or if a label is paid, shipped, or voided—click Archive (or Archive All) to move it out of your active dashboard. To permanently erase archived shipment metadata and cached PDF label files from disk, navigate to Profile → Delete Archived Shipments.