Vinoshipper Integration

Vinoshipper is a wine-specific shipping platform that handles state-by-state compliance, age verification, adult-signature delivery, and temperature-controlled options for direct-to-consumer wine. Use Vinoshipper when wine compliance is a hard requirement; for broad multi-carrier coverage without wine-specific rules, see Shippo. You can also run both — different tiers can use different providers.

Vinoshipper is a business-group-wide integration. You connect it once and it covers shipping for every location in your business.

The Vinoshipper page lives at Dashboard → Integrations → Vinoshipper (/dashboard/integrations/vinoshipper). Use Learn more in the page header to return to this article.

What Vinoshipper Enables

State-by-state compliance — Vinoshipper applies the right rules per destination state, including blocked states and per-state limits.
Direct-to-consumer wine shipping — Native support for DTC carriers and wine-club shipping flows.
Temperature-controlled options — Pass-through to carriers that support refrigerated or insulated transport.
Adult signature required — Compliant signature-on-delivery for every shipment.
Producer-level account — Each Vinoshipper account represents a producer; the connection records your producer name on first sync.

For per-tier shipping setup, see Shipping configuration.

Connecting Vinoshipper

When the integration is not connected, the page shows Connect Vinoshipper with two cards.

Step 1: Choose the integration scope

The first card, Integration Scope, has two radio options laid out side-by-side:

Business-wide (with a building icon) — "Use the same Vinoshipper account for all locations." Marked with a blue Recommended badge. Default selection.
This Location Only (with a map-pin icon) — "Use a separate Vinoshipper account for this location." Marked with a gray Coming soon badge and disabled.

For now, leave Business-wide selected.

Step 2: Enter your API credentials

The second card, API Credentials, has two fields side-by-side:

API Key field — A text input (key icon) with the placeholder e.g. 5755.79C7ED5B3FEC43A6. The portion before the first dot is your Vinoshipper account ID — WineView extracts it automatically.
API Secret field — A password-type input (key icon) with the placeholder Your API Secret.

Below the inputs, a help line:

"Contact Vinoshipper support if you need help finding your API credentials."

A purple Wine Shipping Specialists info box lists what the integration provides:

State-by-state compliance built in
Direct-to-consumer wine shipping
Temperature-controlled options
Adult signature required

Step 3: Test and connect

Below a separator, three buttons:

Connect Vinoshipper — Primary purple button. Disabled until both API Key and API Secret are filled. Reads "Connecting…" while processing.
Test Connection — Outline button that calls Vinoshipper without saving the credentials. On success, a toast appears: "Connected! Producer: {your producer name}." On failure: "Connection failed: {error message}." Use this to verify credentials before committing.
Learn More — Outline button that opens vinoshipper.com in a new tab.

Tip: Always click Test Connection first. If the producer name comes back correct, then click Connect Vinoshipper to save.

Where to find your API credentials

Vinoshipper does not expose API credentials in the merchant dashboard by default. Email support@vinoshipper.com and ask for an API Key and Secret for your producer account. Include your producer name and account ID. They typically respond within 1–2 business days.

Connected View

Once Vinoshipper is linked, the page header changes to Vinoshipper with the integration name as the description. A Learn more button and a status badge (Active / Inactive / Error) showing scope (Business-wide) appear in the upper right.

Integration Details

Field	Description
Account ID	Your Vinoshipper account identifier (the prefix of your API Key). Monospace, read-only.
API Token	Masked secret (e.g., `••••••••`). Read-only. To rotate, disconnect and reconnect with new credentials.
Connected On	The date and time the integration was connected.

If a recent call failed, an inline error alert appears below the fields with the failure message.

Below a separator, action buttons:

Activate / Deactivate — Toggles the integration's active state without removing the credentials.
- Activate enables wine shipping rates and label generation.
- Deactivate disables it without disconnecting; you can re-activate later in one click.
Open Vinoshipper — Opens vinoshipper.com in a new tab.

Day-to-Day Use

Once Vinoshipper is Active:

Rate display — Tiers configured to ship via Vinoshipper pull live rates per destination state. Disallowed states are surfaced before checkout.
Compliance handling — Each shipment is automatically validated against state limits (volume, ABV, license type) before a label is generated.
Adult signature — All Vinoshipper shipments require adult-signature on delivery; the carrier enforces this.
Tracking — As packages move, WineView pulls tracking events and updates each reservation.

For the per-tier shipping option (which provider is used and how cost flows back to the member), see Shipping configuration.

Troubleshooting

Symptom	What to check
Status: Error	Open the error alert on the Integration Details card. The most common cause is a credential mismatch after Vinoshipper rotates an API Secret — disconnect, request a fresh secret from support, and reconnect.
Test Connection succeeds but Connect Vinoshipper fails	Refresh the page and try again. If it persists, contact WineView support — the underlying Vinoshipper API can occasionally rate-limit during onboarding.
A specific state isn't quoting	Vinoshipper enforces state-level rules. If a state shows as restricted, check the Shipping States allowlist in your business group settings and confirm Vinoshipper has compliance for that state. See Shipping configuration.
Producer name shows wrong on test	The API Key prefix is being parsed as the account ID. If the producer name returned doesn't match your business, you may have been issued the wrong credentials — contact Vinoshipper support.
Labels aren't generating	Check that the listing tier has package dimensions and weight, the destination is allowed, and your Vinoshipper plan covers the package class (refrigerated, etc.).

Disconnecting Vinoshipper

To remove the connection, click Deactivate first if you want to keep credentials on file but pause shipping. To remove permanently, contact support — Vinoshipper disconnect is currently a server-side cleanup to ensure in-flight shipments are not orphaned.

When disconnected:

The connection to Vinoshipper is removed; tiers configured to use it fall back to other providers if configured.
Existing labels and tracking remain on each reservation.
Reconnecting later requires re-entering your API Key and Secret.

Vinoshipper vs. Shippo

Need	Use
Wine-specific compliance, state limits, adult signature built-in	Vinoshipper
Broad multi-carrier coverage, discounted USPS / UPS / FedEx	Shippo
Both	Connect both — assign each tier to whichever provider fits its destinations and packaging

See also