Documentation Index
Fetch the complete documentation index at: https://www.zinc.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Fiat Payments for Agents
Agents paying for orders via the Machine Payments Protocol can now settle in USD using Stripe Payment Tokens (SPT) — no stablecoins, no crypto wallet required. When MPP launched in March agents had to pay in stablecoins on Tempo; with SPT, any agent that can hold a Stripe payment method can place orders on Zinc using regular fiat.Return Lifecycle Webhooks
Four new webhook events cover the full return lifecycle —return.created, return.approved, return.denied, and return.credited — so you can react to return status changes without polling. Each payload includes a new return_id field alongside order_id, making it easy to route events to the right return.USPS Tracking
USPS joins FedEx, UPS, and our existing carriers as a directly-polled tracking source. Orders shipped via USPS now get the same accurate checkpoints, faster delivery confirmations, and full delivery history as everything else.Improvements
- Returns in sandbox — The returns API now routes through sandbox in test mode, so you can exercise the full return flow without touching production
order.cancelled webhook event, a meaningful round of improvements to returns, and reliability fixes across the ordering and wallet flows.order.cancelled Webhook
A new order.cancelled webhook event fires when a retailer cancels an order after placement. The payload includes the cancellation reason and source so you can react without polling — your wallet is refunded automatically at the same time.Returns Improvements
Building on the returns API and dashboard we launched in March, returns now feel like a complete workflow:- Resolution notes — When a return is closed, the notes from our review are now visible on the return
- Filter orders by return status — The orders dashboard now lets you filter by open or closed returns for at-a-glance visibility
Improvements
- Faster retailer-cancellation detection — Retailer-side cancellations are now detected and refunded more quickly
- Wallet top-up safeguards — Additional protections around concurrent top-up requests
- Pre-placement balance check — Wallet balance is now verified against the retailer’s final total (including tax and shipping) before the order is placed
order.delivered webhook event, and a redesigned status page.FedEx and UPS Tracking
Zinc now polls FedEx and UPS directly for delivery status, alongside our existing carrier coverage. You’ll see more accurate checkpoints, faster delivery confirmations, and a full delivery history for every shipment.order.delivered Webhook
A new order.delivered webhook event fires when every package on an order has been delivered. Pair it with order.placed and order.failed to close the loop on an order without polling.Status Page
The new status page gives you an at-a-glance view of platform health across five service tiers — Ordering, Tracking, Product Data, API, and Dashboard — with 90 days of history for each. Every tier is rolled up from real production health checks, so what you see is what we’re seeing.Improvements
- Per-item delivery status — The orders dashboard now shows delivery status for each line item (delivered, shipped, ordered, processing, cancelled), so partial shipments are easier to track at a glance
Ordering Reliability
A handful of improvements to our ordering pipeline to keep success rates high as volume grows:- Faster tracking updates — Order tracking is now polled hourly for up to 14 days after placement, so status changes land in your dashboard sooner
- Smarter retries — Transient retailer errors now retry with unique trial IDs to avoid duplicate-detection conflicts
- More precise error mapping — Out-of-stock products now surface as
product_unavailableinstead of a generic failure, with clearer messaging across the board
Improvements
- Full order history — The orders dashboard now shows your complete order history with infinite scroll pagination, instead of being capped at the 50 most recent orders
- Passkey warning — A reminder to disable passkeys on retailer accounts is now shown when adding or editing a managed account
Billing Page
The new billing page gives you a complete picture of your spending and deposits in one place:- Per-order cost breakdown — Product cost and Zinc fee broken out for every order
- Deposit history — Every deposit with a direct link to its Stripe-hosted receipt for easier accounting
Automatic Wallet Credits from Bank Transfers
ACH and wire transfers to your virtual Stripe account now credit your Zinc wallet automatically. No more emailing support to top up — send the transfer and your balance updates as soon as it arrives. Reversals are handled too.Improvements
- Retailer-initiated cancellations — Orders cancelled by the retailer are now tracked under their own status and automatically requeued for a fresh attempt when we detect a cancellation email
- Full tracking numbers — Tracking numbers in the dashboard are no longer truncated at 12 characters
- Consistent timestamps — All timestamps in the dashboard now render in your browser’s timezone with consistent formatting
Teams
If your team places orders through Zinc, you can now see every teammate’s orders in a single shared view, so you don’t have to hop between accounts to find an order someone else placed.Teams is rolling out gradually. To get set up, reach out to support@zinc.com and we’ll create your organization and invite your teammates.
Email Improvements
We’ve made order emails more useful:- Price breakdowns in receipts — Order emails now include subtotal, shipping, tax, and total
- Order placement emails are now opt-in — Disabled by default due to deliverability issues; you can turn them back on from your email notification preferences
Improvements
- Faster orders dashboard — Added pagination and tuned backend queries so the orders page stays snappy no matter how many orders you’ve placed
- More reliable sign-in — Fixed an issue where transient auth provider timeouts could briefly strip admin access; sessions now fall back to cached roles when the provider is slow
Amazon Prime Support
Zinc now supports Prime shipping on Amazon orders. If you’re interested in enabling this for your account, reach out to support@zinc.com.Email Notification Preferences
You can now customize which email notifications you receive — including order placed and order failed alerts — directly from the dashboard settings.Improvements
- Duplicate transaction prevention — Resolved a rare issue that could cause duplicate charges during payment processing
- Tracking improvements — Better tracking number selection, with added support for znlogic tracking links
Return Request API
Zinc now supports returns through a new set of API endpoints. Create return requests, list them, and check their status — all programmatically.POST /returns— create a return request for any completed orderGET /returns— list all return requestsGET /returns/{id}— get the status of a specific return
Product Data API
New product data endpoints are now available under/products, giving you programmatic access to product search, offers, and details.- Product search across supported retailers
- Offer data with pricing and availability
- Product details by URL or identifier
Improvements
- Timezone handling — dates in the dashboard now display in your local timezone
Machine Payments Protocol (MPP)
Zinc now supports the Machine Payments Protocol (MPP) — an open standard for machine-to-machine payments over HTTP. Instead of requiring API keys, subscriptions, or upfront enrollment, MPP lets AI agents pay for each order individually as part of the same HTTP request that places it.Here’s how it works: an agent calls Zinc’s order endpoint, receives an HTTP 402 payment challenge, fulfills the payment, and gets the order confirmation back — all in a single exchange. No checkout forms, no stored credentials, no human in the loop.- Stablecoin payments via Tempo — Agents can pay per-transaction using stablecoins on Tempo, with fast settlement and predictable costs
- Stripe Payment Tokens — Support for Stripe-based fiat payments via SPT coming soon
- Automatic refunds — If an order fails, the payment is automatically refunded
- Partial refunds — When the final order price is less than the agent’s
max_price, the difference is refunded
Bug Fixes
- Legacy v1 API fix — Resolved an issue where quantity was hardcoded to 1 in legacy v1 API order requests
Coming Soon: Machine Payments Protocol (MPP)
We’re building native support for the Machine Payments Protocol — a fully-agentic purchasing protocol that lets AI agents pay for orders programmatically. MPP support will go live early next week with Tempo and Stripe as payment methods, starting with Amazon and Zinc retailers. Stay tuned.API Key Rotation
You can now rotate your API keys directly from the credentials dashboard. Key rotation lets you cycle credentials without downtime — generate a new key, migrate your integrations, then revoke the old one.Expanded Retailer Information
The retailer status API now includes asupported_countries field, making it easier to programmatically check which countries each retailer can ship to.Improvements
- Merchant order IDs in order results —
merchant_order_idis now included in order responses for easier cross-referencing with retailer records - Smarter order retries — Retried orders now correctly preserve variant information, retailer credentials, PO numbers, and metadata from the original order
- Webhook reliability — Fixed sandbox webhook processing issues
- Better international address autocomplete — Improved address suggestions for international orders
- More accurate order pricing — Better extraction of order price details when payment currency differs from the listing currency
Great Britain Shipping
Zinc now supports shipping to Great Britain, continuing our expansion of international address coverage. GB addresses are fully validated during order creation.International Currency Support
Orders placed on international retailers now automatically handle foreign currency conversion. Non-USD order totals are converted to USD at charge time with a configurable FX markup (3% default) applied to conversion rates as a buffer against exchange rate fluctuations. This means you can place orders on retailers in EUR, AUD, GBP, and other currencies without worrying about currency handling — Zinc takes care of it.Estimated Delivery Dates
When provided by the retailer, estimated delivery dates are now included in your order details.Improvements
- More reliable merchant order IDs — Fixed handling of edge cases where merchant order IDs aren’t immediately available after checkout
- Enhanced error handling — More resilient parsing and retry logic for smoother order completion
Home Depot Support
Zinc now supports placing orders on Home Depot, expanding our retailer coverage to one of the largest home improvement retailers.Estimated Delivery Dates
If provided by the retailer, Zinc will now extract estimated delivery dates during the checkout process and include them in your order details.International Currency Support
Orders placed on retailers that use non-USD currencies are now automatically converted to USD at charge time. This makes it easier to place orders on international retailers without worrying about currency handling.Retailer Status Page
We’ve added a user-facing retailer status page so you can monitor which retailers are currently supported and their operational status.Improvements
- Better rural address support — Fixed validation failures for rural and highway addresses where USPS data is limited
- Clearer validation errors — Enhanced error messages for invalid addresses
- Max price display — The order detail page in the dashboard now shows the max price set for each order
- Direct product links — Order details now include direct links to the product URL
- Editable addresses — Address fields are now editable in the create order flyout after selection
Canadian Shipping Addresses
Zinc now supports shipping to Canada, continuing our expansion of international address coverage. Canadian addresses are fully validated during order creation.Saved Payment Selection
When using managed accounts, you can now select which saved payment method to use for an order. If you have multiple cards on file with a retailer, you can specify exactly which one Zinc should use during checkout.LaserShip Tracking Support
Orders shipped via LaserShip now include tracking numbers, giving you visibility into deliveries from this regional carrier.Improvements
- Better tracking extraction — Improved tracking number and verification code extraction with fewer false positives
- Smarter email filtering — Enhanced filtering of emails before extracting tracking and verification data
- More accurate merchant order IDs — Improved extraction of merchant order IDs from retailer confirmations
Account-less Checkout for Walmart, Target & Wayfair
Until now, Zinc-managed checkout accounts were only available for Amazon. This week, we’re bringing the same experience to Walmart, Target, and Wayfair — meaning you can place orders on these retailers without creating or managing your own accounts. Just provide a shipping address and payment method, and Zinc handles the rest using our managed credentials.This is a major step forward: retailers that previously required you to bring your own account credentials are now accessible out of the box. And this is just the beginning — we’ll be rolling out managed checkout to more retailers soon.International Shipping: New Zealand & Australia
Zinc now supports shipping to New Zealand and Australia, continuing our expansion of international address coverage. Addresses for both countries are fully validated during order creation.Payment Verification for Managed Accounts
Managed accounts now support retailer-specific payment verification. If a retailer requires additional payment confirmation during checkout, Zinc stores and uses the appropriate verification hints automatically.SMS Verification Code Support
Our checkout system now supports OTP retrieval from forwarded SMS verification codes, in addition to email-based codes. This improves success rates for retailers that use SMS-based authentication.Improvements
- Smarter cart validation — Fixed checkout failures caused by cart information no longer being displayed on the page
- Better error codes — Added a specific
payment_verification_requirederror code for clearer debugging
Universal Checkout Skill
- Natural language ordering — Ask your agent to buy a product by URL, and it handles the rest
- Search-to-purchase — Pair with Brave Search to find and order products in one workflow
- Confirmation built in — The agent always confirms before spending real money
Auto Wallet Top-up
Never run out of funds mid-order. You can now configure automatic wallet top-ups that trigger whenever your balance drops below a threshold. Set your minimum balance and top-up amount from the new wallet settings page, and Zinc handles the rest.Order Progress Timeline
Order details now include a visual timeline showing each step of the purchasing flow. See exactly where your order is and what’s already been completed.Improvements
- Email forwarding indicators — A new badge shows when forwarded verification emails have been detected for your managed accounts
- Better Amazon tracking — Improved package tracking URL extraction from Amazon order emails
- International address fixes — Fixed address validation for countries that don’t require a state or province field
Retailer Status Page
TOTP Support for Retailer Credentials
Managed retail accounts now support Time-based One-Time Passwords (TOTP). If your retailer account uses two-factor authentication with an authenticator app, you can provide your TOTP secret and Zinc will automatically generate codes during login — no more manual verification steps.Improved Order Progress
International Order Support
Zinc now supports shipping to Germany, with more countries coming soon. International addresses are validated during order creation, and we’ve updated our date and currency formatting to handle international locales correctly.- Country configuration — Each retailer now has configurable supported shipping countries using ISO 3166-1 alpha-2 codes
- Address validation — International addresses are validated before order creation
- Flexible formats — Postal codes work with both
zip_codeandpostal_codefields, and state/province fields are now optional for countries that don’t require them
Purchase Order Support
For B2B customers, you can now include a purchase order number with your orders. Just pass an optionalpo_number field and we’ll automatically detect PO number fields during checkout and fill them in.Product Variant Fixes
Fixed an issue where variant verification was failing for products that have pre-selected variants on the page. Variants should now work correctly across all supported retailers.
Launch Week 1
January 20-24 — Zinc’s first launch week. Five days. Five releases.We’re rapidly expanding Zinc 2.0’s feature-set, vastly improving devex, and showing off some impressive demos to inspire you on what you can build with Zinc.Pay attention to your inboxes and our socials for Launch Week 1!Account Selection in Orders
- Visual account picker — Select from your saved retailer accounts directly in the order form
- Curl command preview — See the exact API call that will be made, with one-click copy
Easier Gmail Setup
Setting up email forwarding for verification codes just got simpler. A new “Add Gmail Filter” button generates the exact filter you need with one click.Smarter Retry Logic
We’ve improved how failed orders are retried to be more intelligent about when retries make sense.- Order-level tracking — Retry attempts are now tracked at the order level for better visibility
- Skip hopeless retries — Orders that fail due to out-of-stock products, inaccessible items, or unavailable guest checkout no longer waste time retrying
Managed Retail Accounts
- Amazon account support — Orders placed with Amazon credentials now use our enhanced processing system for better reliability
- Forwarding email addresses — Each managed account automatically gets a dedicated email address for verification codes and tracking notifications
- Easy credential reference — Use short IDs to quickly identify and reference your saved retail credentials
- Explicit credential selection — Specify exactly which credentials to use with the
retailer_credentials_idparameter
Smarter Payment Handling
When using managed accounts, Zinc now automatically uses your saved payment method if you don’t provide one explicitly. This means less redundant data in your API calls.- Automatic payment detection — Orders with managed accounts can use saved payment methods without passing payment details each time
- Flexible payment modes — Switch seamlessly between saved and explicit payment methods based on your needs
- Clear error messages — Get helpful
payment_method_requirederrors when a saved method is needed but doesn’t exist
Streamlined Onboarding
We’ve simplified the getting-started experience to help you start testing faster.- Skip optional steps — Skip non-essential onboarding steps and dive straight into testing
- Faster setup — Streamlined flow gets you to your first test order more quickly
Better Error Tracking
Enhanced error reporting throughout the platform helps you debug issues faster with more specific error types and clearer messages.
Better Order Search
You can now search for orders by order ID, making it easier to find specific orders in your dashboard.Clearer Price Warnings
When an order exceeds your maximum price threshold, you’ll now see a clear “Max Price Exceeded” warning instead of a generic failure message. This makes it easier to understand why an order didn’t complete.Infrastructure Improvements
We’ve been working on backend improvements to support future features:- Multi-worker architecture — Building distributed systems for better scalability
- Enhanced authentication — Improving support for retailer accounts that require login
- Better error tracking — Expanding our monitoring to catch and fix issues faster
Product Variant Interpretation
- Intelligent parsing — Automatically interpret size, color, and style options from plaintext strings
- Flexible input — No need to pre-structure variant data, just provide the information naturally
- Clear label/value pairs — Properly formatted variants for accurate order placement
Better Test Order Flow
- URL preview cards — See product images and details before placing test orders using Open Graph metadata
- Variant support — Test orders now fully support product variants with the new interpretation system
- Mobile-optimized — Fully responsive order interface that works seamlessly on mobile devices
Improvements
- Better error messages — Clearer feedback when payment or order issues occur
- Fixed retry logic — Order retry now works correctly and only triggers for failed orders
V2 Beta Launch
- More Retailers: Dramatically expanded retailer support across the world’s top online stores
- Modern API: Clean, consistent API design for better developer experience
Some v1 features (account automation, tracking, returns) are coming soon. See migrating from v1 for details.
Order Management
- Cancel orders — Stop orders before they’re fulfilled when plans change (available in dashboard)
- Retry failed orders — Automatically retry orders that failed due to temporary issues (available via API)
Amazon Integration
Platform Improvements
We’ve also made several improvements to the overall platform experience:- Better order display — Improved how order details are shown in the dashboard
- Payment notifications — Clearer notifications when payment methods need attention
Wallet Management
More Reliable Orders
Orders now automatically retry when they encounter temporary issues, making the overall process more reliable. We’ve also made several improvements:- Smarter price checking — We now validate prices only at the final checkout step, reducing premature order failures
- More accurate pricing — Enhanced price extraction logic handles varied retailer formats more reliably