Build a custom DtC checkout with the Vinoshipper order APIs

domain: vinoshipper.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Call POST /api/v3/p/orders/estimate-shipping with the ship-to address and product/quantity list to retrieve available carrier rates (e.g. UPS Ground, 2nd Day Air) and let the customer choose one.
  2. Call POST /api/v3/p/orders/estimate-taxes with the same products plus the chosen shippingRate to get a tax/fee breakdown, using the response's `extraFeesTotal`, `taxesTotalWithoutFees`, and `taxesTotal` fields for display.
  3. Call POST /api/v3/p/orders with customer info (including date of birth for age verification), shipToAddress, products, the selected shippingRate, and the `fees`/`taxes` values from the estimate step to create the order.
  4. To charge a card directly, first create the order without `paid: true` (it will be PENDING), call the Create SetupIntent API for a Stripe `clientSecret`/`publishableKey`, confirm the card with Stripe.js, then call POST /api/v3/p/orders/{orderNumber}/purchase with the resulting `stripePaymentMethodId`.
  5. Check the response for `status: SUCCESS` and `isCompliant: true` to confirm the order was created and passed compliance.
  6. On failure, branch on error type: HTTP 400 validation errors (fix the request), HTTP 200 with `isCompliant:false` and an `orderProblems` array (compliance violation — the order can still be updated via the Update Order API), or HTTP 5xx server errors (retrying can help for transient issues, and log the `vs-trace-id` response header for support).

Known gotchas

Related routes

Build a custom checkout on BigCommerce using the Checkout SDK
developer.bigcommerce.com · 6 steps · unrated
Create a BigCommerce headless checkout flow using the REST Management API from cart creation through order placement
developer.bigcommerce.com · 6 steps · unrated
Complete a BigCommerce headless checkout via the Checkout API
bigcommerce.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans