Traide Changelog

Added the value input field to AttributeValueInput to support more input type usages, such as the color value for swatch attributes.

Added metadata and privateMetadata to the following models:

• ShippingMethod
• ShippingZone

Manage metadata with the metadataUpdate and privateMetadataUpdate mutations.

Fixed an issue where the customer_updated webhook was not being triggered by adding a customer address.

Deprecated the isSellerShippingZoneCreationAllowed field on the MarketplaceConfiguration model. This field will now always be overridden as true and wil be removed soon.

Unique seller slugs​

Sellers now have unique URL-friendly slugs, making it easier to reference and link to seller profiles throughout the platform.

Query sellers by slug​

Added the ability to query sellers using their unique slug, providing a more user-friendly way to retrieve seller information.

Public seller information​

Introduced a public seller query that returns limited seller information, ideal for displaying seller profiles on storefronts without exposing sensitive data.

Storefront theme customization​

Added support for storefront theme modeling, enabling customization of storefront appearance and branding through queries and mutations.

Media management​

Introduced new media queries and mutations for managing media assets across the platform, providing better control over images, videos, and other media content.

Content management​

Added content type support with queries, enabling more flexible content management capabilities within the platform.

Enhanced shipping zone configuration​

Added support for country-area shipping zones, providing more granular control over shipping configurations by geographic region.

Expanded fee support​

Platform fees can now be applied to any orders, providing more flexibility in how marketplace fees are structured and applied.

Legacy dashboard configuration fields have been marked as deprecated and will be removed in a future release. Please migrate to the new configuration system.

Fixed an issue where shipping sale discounts were not being properly subtracted from order totals.

Fixed an issue preventing seller slugs from being edited through the API.

Fixed validation issues with sale discount amounts that could result in incorrect discount calculations.

Fixed an issue where voucher discounts were not being apportioned correctly across order lines, ensuring accurate per-line discount calculations.

Improved the accuracy of order payout status filtering, ensuring queries return the correct results.

Fixed an issue where image fields were missing alt text attributes.

Fixed an issue where WorkOS user profile information was not being properly retrieved during SSO token creation.

Fixed an issue where inactive sales were being displayed on product and variant pages. Only active sales are now shown.

Seller slug field​

Added the slug field to the Seller model.

PublicSeller model​

Added the PublicSeller model, to retrieve public information about sellers. Also added the sellerBySlug query to retrieve a publicSeller by their unique slug.

Fixed an issue where you could not add order fees to fulfilled orders.

Deprecated dashboard types​

The following types related to the Dashboard have been deprecated:

• The dashboard query
• The dashboardConfigurationUpdate mutation

Sales and vouchers on products and variants​

Added the ability to view all active sales and vouchers directly on product and variant objects, making it easier to understand which discounts apply to specific items.

Voucher apply-once per product​

Added support for vouchers that can be configured to apply only once per product, even when multiple quantities are in the cart. This provides more granular control over discount application.

Sale shipping type updates​

Sales can now be updated to change their shipping type, providing more flexibility in managing promotional campaigns.

Filter staff users by active status​

Added the ability to filter staff users by their active/inactive status, making it easier to manage team member access.

Marketplace default country configuration​

Added a default country setting to marketplace configuration, which is now used throughout the platform for better localization support.

External ID support for warehouses and product images​

Warehouses and product images can now be created or updated using external IDs and sources, simplifying integration with external systems.

Performance improvements​

Made several performance improvements across the platform:

• Updating shipping methods on orders is now significantly faster.
• Creating draft order lines is more efficient.
• Discount calculation performance has been optimized throughout checkout and order flows.

Password reset improvements​

The password reset mutation now allows the redirect URL to be optional, providing more flexibility in implementation.

Fixed an issue where vouchers configured for specific products would incorrectly calculate discounts based on the entire cart subtotal instead of only the specified products.

Fixed an issue where removing the last item from a checkout could cause errors when discounts were applied.

Fixed an issue where sale discount amounts were not properly updated when order line quantities changed.

Fixed an issue where discount amounts in the ledger were incorrect on order finalization.

Fixed an issue where older orders would fail to load when discount v2 features were enabled.

Fixed an issue where adding products to checkouts could cause errors in certain scenarios.

Fixed an issue where the platform could crash if Avalara returned incomplete transaction data.

Fixed how voucher data is sent to Avalara for invoice creation, resolving checkout issues related to tax calculation.

Fixed an issue where invalid refunds could be incorrectly connected to payouts in the ledger flow.

Fixed an issue with Stripe configuration where the auto-capture setting was not properly retrieved.

Fixed an issue with product and variant substatuses not displaying correctly.

Fixed an issue where the PRODUCT_UPDATED webhook was not firing when product features were modified.

Removed deprecated API features​

Removed several long-deprecated queries, mutations, and fields from the API:

• Service account queries and mutations
• Barcode queries
• Legacy webhooks query
• Various deprecated type fields

If you are still using these deprecated features, please update your integration to use the recommended alternatives.

The staffUserInput type now accepts the userIsActive field, which is a boolean that can be used to filter if a staff member is active or not.

Improved handling when Avalara doesn't return a response after posting a transaction.

The product_updated webhook will now be triggered by changes to product features.

Added a MarketplaceConfiguration field for defaultCountry, which will be used to set the default country in the storefront in a future release.

Fixed an issue where refunds in an invalid state could connect to payouts.

Product review deprecations​

The following types have been marked for deprecation and will be removed on October 1, 2024:

• The productRatingsAndReviews query
• The productReviewSubmit mutation

Catalog export deprecations​

The catalogExport mutation is no longer supported and has been marked for deprecation. This will be removed on October 1, 2024.

Catalog type removals​

The following previously deprecated types related to catalog management have been removed:

Order type removals​

The following previously deprecated types related to checkout and orders have been removed:

Warehouse type removals​

The following previously deprecated warehouse mutations have been removed:

User type removals​

The following previously deprecated user management mutations have been removed:

Webhook type removals​

The following previously deprecated webhook and service account types have been removed:

Seller type removals​

The following previously deprecated seller-related mutations have been removed:

Designer type removals​

The following previously deprecated designer-related mutations have been removed:

Metadata type removals​

The following previously deprecated metadata mutations have been removed:

YotPo plugin removal​

The YotPo plugin has been removed, including removal of the following types:

• YotpoCustomer
• UserInput
• customerLoyaltyAndReferralsDetails
• loyaltyAndReferralsInfo
• YotpoCustomer
• yotpoLoyaltyAndReferralsCreateOrUpdateCustomerRecord
• yotpoLoyaltyAndReferralsAwardCustomerLoyaltyPoints

CORS configuration improvements​

Enhanced CORS (Cross-Origin Resource Sharing) configuration to support environment-based settings, providing more flexibility when deploying the API across different environments.

Discounted unit price display​

Checkout lines now display the discounted unit price, making it easier for customers to see savings at the line-item level during checkout.

Product and variant creation with existing attributes​

Added support for creating products and variants using existing attribute values, streamlining the product setup process for sellers with established attribute libraries.

Discount ledger recordings​

Financial ledger entries now include detailed discount information, providing better tracking and reporting of promotional impacts on orders.

Feature flag-based pricing and tax display​

Pricing and tax information across checkout and orders now respects feature flag configurations, allowing for more flexible rollout of pricing changes and tax calculation methods.

Order data access from order lines​

Order lines now expose their parent order data, enabling better integration with refund management interfaces.

Fixed an issue where payment capture amounts could exceed the revised order total, preventing overpayment in cases where orders were modified after initial authorization.

Fixed an issue where the discounted total wasn't being properly saved when completing checkout, ensuring accurate order totals.

Fixed an issue where payment status could display incorrectly for certain orders, improving order management clarity.

Fixed an issue where sale discounts were being incorrectly adjusted when recalculating draft orders, preserving the intended discount amounts.

Fixed an issue where orders with a full discount, leaving a balance of $0, were not being marked as paid.

External ID support for products and variants​

Added the ability to specify an external ID when creating products and variants, making it easier to integrate with external systems and maintain cross-platform references.

Improved voucher discount calculations​

Fixed voucher discount calculations to ensure accurate pricing when applying promotional codes at checkout.

Marketplace configuration updates​

• Supported currencies are now managed through marketplace configuration instead of domain settings, simplifying multi-currency setup.
• Removed deprecated domain and client-related GraphQL queries and mutations, streamlining the API surface.

Attribute value references​

Updated how attribute value references are handled, improving consistency when working with product attributes.

Fixed an issue where refunds not connected to orders could cause errors during payout processing.

• Stripe webhook events now properly update refund status.
• Credit card details are now correctly populated during Stripe webhook processing.
• Refunds are no longer processed multiple times, preventing duplicate transactions.
• Fixed handling of refunds charged to multiple sellers simultaneously.

• Guest users can now view their own orders on the thank you page.
• Ensured that declined quantities are always positive values.
• Fixed an issue with quote orders that have a total amount of zero.

• Fixed checkout purchase event tracking.
• Resolved an issue when removing vouchers from checkout.

Made user ID optional for source permission groups, improving flexibility in permission management.

Fixed an issue where refunds processed through Stripe were not consistently being updated to the PAID status.

Fixed an issue where refunds charged to the seller were not included in the seller payout calculations in certain cases.

Fixed an issue with the payout summary for a seller order (order.payoutsSummary.refunds), where the reported refund amount could be incorrect in certain situations. This issue did not affect the actual payout amount.

Removed the sites model, referred to as domains in the dashboard. Supported currencies for the marketplace will now be read from MarketplaceConfiguration.