> ## 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. # Changelog > Product updates and improvements to Zinc API Week of May 11 updates

This week we're shipping a new `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`](/v2/api-reference/order-updates/webhooks) 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](#2026-04-03) 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 Week of May 4 updates

This week we're launching FedEx and UPS tracking, a new `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`](/v2/api-reference/order-updates/webhooks) 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](https://zinc.com/status) 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 Week of Apr 27 updates

A lighter week of feature work, focused on durability and scale. Order volume has grown a lot over the past few months, and we want Zinc to feel rock-solid at any size — so this week is about hardening the ordering pipeline and dashboard to be more resilient under that demand, with fewer transient failures and faster recovery when something does go wrong. ### 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_unavailable` instead 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 Week of Apr 20 updates

This week we're launching a redesigned billing page and automatic wallet credits from bank transfers. ### Billing Page The new [billing page](https://app.zinc.com/billing) 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 Week of Apr 13 updates

This week we're launching Teams — a shared view of orders across your teammates — plus email deliverability improvements and a faster orders dashboard. ### 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](mailto: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 Week of Apr 6 updates

This week we're launching Amazon Prime support, plus email notification preferences and payment reliability improvements. ### 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](mailto: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 Week of Mar 30 updates

With returns and product data now available in v2, Zinc has reached full feature parity with the legacy v1 API. If you're still on v1, now's the time to [migrate](/v2/migrating-from-v1) — v2 is the future. ### 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`](/v2/api-reference/returns/create-return) — create a return request for any completed order * [`GET /returns`](/v2/api-reference/returns/list-returns) — list all return requests * [`GET /returns/{id}`](/v2/api-reference/returns/get-return) — get the status of a specific return Returns can also be managed from the new Return Management section in the dashboard. ### Product Data API New product data endpoints are now available under `/products`, giving you programmatic access to product search, offers, and details. * [**Product search**](/v2/api-reference/products/search) across supported retailers * [**Offer data**](/v2/api-reference/products/get-product-offers) with pricing and availability * [**Product details**](/v2/api-reference/products/get-product) by URL or identifier ### Improvements * **Timezone handling** — dates in the dashboard now display in your local timezone Week of Mar 23 updates

This week we're launching support for the Machine Payments Protocol — enabling AI agents to pay for Zinc orders per-transaction, with no accounts or API keys required. ### Machine Payments Protocol (MPP) Zinc now supports the [Machine Payments Protocol](https://mpp.dev/) (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](https://tempo.xyz), 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 Try it out in the [Agent Playground](https://agent.zinc.com), or check out the [MPP guide](/v2/mpp) and [create order endpoint](/v2/api-reference/agent/create-order) to get started.

Zinc Agent Playground — let your agents buy anything online

### Bug Fixes * **Legacy v1 API fix** — Resolved an issue where quantity was hardcoded to 1 in legacy v1 API order requests Week of Mar 16 updates

This week brings API key rotation, expanded retailer information, and improved order reliability — plus a preview of what's coming next. ### Coming Soon: Machine Payments Protocol (MPP) We're building native support for the [Machine Payments Protocol](https://mpp.dev/) — 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 a `supported_countries` field, making it easier to programmatically check which countries each retailer can ship to. ### Improvements * **Merchant order IDs in order results** — `merchant_order_id` is 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 Week of Mar 9 updates

This week brings Great Britain shipping, smarter international currency handling, estimated delivery dates, and improved order reliability. ### 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 Week of Mar 2 updates

This week brings Home Depot support, estimated delivery dates, international currency handling, and a new retailer status page. ### 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](https://app.zinc.com/retailers) 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 Week of Feb 23 updates

This week brings Canadian shipping support, saved payment selection for managed accounts, and improved tracking reliability. ### 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 Week of Feb 16 updates

This week brings expanded retailer support with account-less checkout, international shipping to new regions, and improved order reliability. ### 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_required` error code for clearer debugging Week of Feb 9 updates

This week's highlight is the launch of our Universal Checkout Skill for AI agents, plus auto wallet top-up and better order visibility. ### Universal Checkout Skill

Zinc is now available as an [Agent Skill](https://agentskills.io) — a new way for AI agents to place orders through natural language. Install the [Universal Checkout Skill](/v2/agent-skills/overview) into [OpenClaw](/openclaw), Claude Code, or Gemini CLI, and your agent can search for products, place orders, and check statuses — all from a single conversation. * **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 [Learn more →](/openclaw) ### 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 Week of Feb 2 updates

This week's highlight is a brand new retailer status page, plus stronger account security and better order visibility. ### Retailer Status Page

Zinc now has a dedicated status page with nightly integration test results for our top retailers. We're committed to full transparency into what's working and what isn't — and we'll be expanding coverage to more retailers over time. ### 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 Incremental order status updates

Orders now report more granular progress updates as they move through each step of the purchasing flow, giving you better real-time visibility into order status. Week of Jan 26 updates

This week we're focused on reliability and expanding Zinc's reach with international shipping support and B2B features. ### 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_code` and `postal_code` fields, 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 optional `po_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. Week of Jan 12 updates

### 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 Account selection dropdown

The order form now includes a dropdown to choose between Zinc-managed accounts and your own retailer credentials. You can see exactly which account will be used before placing an order. * **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 Week of Jan 5 updates

This week we're introducing managed retail accounts and smarter payment handling. These features give you more control over how orders are placed and make credential management significantly easier. ### Managed Retail Accounts

You can now use managed retail accounts to place orders with your own retailer credentials. This gives you more control over order placement and unlocks features that require being logged in. * **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_id` parameter ### 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_required` errors 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. Week of Dec 29 updates

A lighter week with focused improvements to order search and price clarity, plus continued infrastructure work. ### 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 Week of Dec 22 updates

This week brought intelligent product variant interpretation and expanded financial management capabilities. The highlight: we can now automatically understand and parse product variants from plaintext strings. ### Product Variant Interpretation

The biggest update this week is our ability to intelligently interpret product variants from plaintext strings. Instead of requiring structured data, you can now provide variant information as natural text and we'll automatically parse it into the correct format. * **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

We've streamlined the in-app test order experience with rich previews and variant management. * **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 Week of Dec 15 updates

We finally released the latest version of Zinc. This initial release brings dramatically expanded retailer support, along with key order management features. ### V2 Beta Launch