Traide Changelog

Metadata on checkout and order lines​

Added support for storing metadata on the CheckoutLine, OrderLine, and NauticalOrderLine objects, providing more flexibility in adding custom line-level data within an order.

Improved order filtering with the me query​

Enhanced the ability for users to filter orders retrieved from the me query. The CustomerOrderFilterInput, which previously only supported filtering by status, now supports many different filter fields.

One such is the ids filter field, which allows users to find a specific order by id.

Customer name in order email payloads​

Updated the order-related customer SendGrid email payloads to include the recipient_first_name and recipient_last_name fields. If the order is for a guest, these fields will be empty.

Learn more ->

Webhook improvements​

Made the following improvements to webhooks:

• Added the checkout token to checkout webhook payloads.
• Improved performance for webhooks containing product image URLs.

Learn more ->

Performance improvements​

Made several performance improvements around order management, including:

• Creating, updating and finalizing draft orders.
• Completing a checkout.
• Refreshing taxes on an order.
• Cancelling a marketplace order, seller order, or quote order.
• Capturing or voiding a payment on an order.

Enhanced payment source storage​

Improved the ability to store payment sources for Stripe payments:

• Credit card brand, expMonth, and expYear can now be stored.
• ACH payment methods can now be saved as a paymentMethodType.

Fixed an issue where event notifications were not being sent during the NauticalDraftOrderLinesBulkDelete mutation.

Fixed an issue preventing full refunds of orders with declined fulfillments.

Metadata on checkout and order lines​

Added support for storing metadata on the CheckoutLine, OrderLine, and NauticalOrderLine objects, providing more flexibility in adding custom line-level data within an order.

Checkout token in notifications​

The checkout notification payload now includes the checkout token, making it easier to reference the checkout in notification handlers.

Order line refunds​

Added support for refunding individual order lines and shipping lines, with detailed tracking codes for each refund. This provides more granular control over partial refunds and better visibility into refund history.

Customer name in order confirmations​

Customer first and last names are now included in the order confirmation payload, making it easier to personalize order confirmation emails and notifications.

ACH payment method tracking​

ACH payment method types are now stored and tracked, providing better visibility into payment methods used for orders.

Performance improvements​

Made several performance improvements across the platform:

• Draft order operations (create, update, delete lines) are now significantly faster.
• Invoice generation for orders with many products is more efficient.
• Order shipping method lookups are optimized.
• Voucher application on marketplace orders is faster.
• Order shipping updates complete more quickly.

Simplified order recalculation​

Introduced a streamlined method to recalculate all pricing and tax information for marketplace orders, making order updates more reliable and consistent.

Fixed an issue where invoice generation could fail or be very slow when creating orders with a large number of products.

Fixed an issue where taxes could be computed before order lines were fully created, leading to incorrect tax calculations in some cases.

Fixed an issue where seller GraphQL responses used an incorrect date format, causing potential parsing errors.

Fixed an issue where accepting a bid would not properly connect the NauticalOrderLine to the OrderLine.

Fixed an issue where shipping calculations used incorrect subtotals when determining shipping costs.

Filter customers by active status​

Added the isActive boolean filter to the customers query.

New seller information fields​

Added the following fields to the Seller model:

• approvedDate
• firstOrderPlacedDate
• firstProductCreatedDate

Updated webhook payloads​

Updated webhook payloads for the following events to be more structured and robust. The structure and contents of the following webhook payloads have been changed:

• nautical_order_created
• nautical_order_updated
• nautical_order_fully_paid
• nautical_order_cancelled

As a result of these changes, existing logic that utilizes the above webhooks should be updated to align with this new webhook format.

Learn more ->

Fixed an issue where volume discounts were being incorrectly deducted from seller order payouts.

Fixed an issue with the Yotpo Ratings and Reviews app not properly utilizing ProductSchema fields.

Fixed an issue where the variant_created webhook was not triggered upon bulk creation of product variants.

Variant creation webhooks for bulk operations​

Webhook events are now triggered when product variants are created in bulk, ensuring all variant creation operations are properly tracked.

Seller activity tracking​

Added calculated fields to track seller activity, including approval status, first product created date, and first order created date.

Active customer filtering​

Added an isActive filter to the customers query, making it easier to filter between active and inactive customer accounts.

Order sorting for customers​

Customers can now sort their order history when querying their own orders through the me.orders endpoint.

Performance improvements​

Made several performance improvements across the platform:

• Checkout queries now use optimized data loading, reducing database queries.
• Sale data is now prefetched during request processing, improving response times.
• Collection product loading is now more efficient, preventing unnecessary reloads.
• Checkout operations use improved data structures for faster calculations.

Fixed an issue where discounts and volume discounts were not correctly set to zero in payout calculations.

Fixed database migration issues and improved model import handling.

Recurring billing (Alpha)​

Introducing the ability to set up recurring orders, allowing you to create subscription-based offerings with customizable frequencies and durations. For example, you can offer subscriptions on a monthly, weekly, or daily basis.

Customers' payment information is securely stored in the payment gateway, such as Stripe, and used for future payments.

• Transform a standard checkout into a recurring order using the checkoutConvertToSubscription. Learn more ->

• Manually initiate a recurring order with the subscriptionCreate mutation. Learn more ->

• Retrieve details of recurring orders using the subscriptions query. Learn more ->

Save cards for future payment (Alpha)​

Introduced the ability to save and reuse payment methods for future transactions:

• Within user.storedPaymentSources, you can now query the id field to retrieve a stored payment method token for a customer. Learn more ->

• The paymentInformation.paymentMethodToken input field in the getClientSecret query enables processing payments using a payment source id obtained from user.storedPaymentSources, instead of entering full payment details. Learn more ->

Sort sellers by creation date​

Added the ability to sort sellers by the created field using the sortBy argument.

Updated webhook payloads​

Updated webhook payloads for the following events to be more structured and robust. The structure and contents of the following webhook payloads have been changed:

• checkout_created
• checkout_updated
• fulfillment_created

As a result of these changes, existing logic that utilizes the above webhooks should be updated to align with this new webhook format.

Learn more ->

Enhanced product pricing fields​

All fields within the ProductPricingInfo and VariantPricingInfo types are now non-nullable.

Also, when multicurrency is disabled, the currency-related fields will now return values in the local domiciled currency.

Token required for payment gateways​

All gateways now require tokens to be supplied to checkoutPaymentCreate or nauticalOrderPaymentCreate.

This should not impact any existing checkouts, as Stripe payments already required a payment token.

Version for plugins​

Added the version field to the plugins model.

Fixed an issue where Stripe webhooks could refund events to Nautical on cancellations in some cases.

Fixed an issue where capture_failed transactions sometimes failed to display an error message.

Fixed an issue with converting a checkout to a quote order with a null shipping method.

Removed VATLayer plugin​

Removed the VATLayer plugin, which has not been supported for some time.

Removed purchase order plugin​

The purchase_order payment gateway has been removed.

Removed credit limits model​

Removed the CreditLimits model, which was not in use.

Removed invoice webhooks​

Removed invoice webhooks, which were not in use.

Removed translations​

Removed the translation model.

Removed deprecated permissions​

Removed the manage_gift_cards and manage_credit_limits permissions.

Adyen payment gateway improvements​

Updated the Adyen payment integration with the latest client library version and added support for tokenized payments, improving security and checkout experience.

App versioning​

Apps now include a version field, making it easier to track and manage integration versions across your marketplace.

Seller sorting by creation date​

Added the ability to sort sellers by their creation date, making it easier to find recently added sellers in your marketplace.

Performance improvements​

Made several performance improvements across the platform:

• Product and variant pricing calculations are now significantly faster.
• Checkout line total calculations are more efficient.
• Transaction code lookups have been optimized.

Fixed an issue where failed payment captures would not display error messages to users.

Fixed an issue where Stripe refund webhooks for cancelled payments could cause errors.

Fixed an issue where checkouts with null shipping methods could cause errors during processing.

Removed features​

The following features have been removed from the platform:

• VATlayer plugin: Removed the VATlayer tax calculation integration.
• Conversations: The conversations feature has been discontinued.
• Product reviews: The Nautical product reviews feature has been removed.
• Purchase order gateway: The purchase order payment method is no longer available.
• Credit limits: Credit limit functionality has been removed.
• Gift cards: All gift card functionality has been removed.
• Translations: Removed translation support for shops, menus, agreements, shipping methods, microsites, pages, attributes, and attribute values.
• Staff notifications: Removed unused staff notification mutations and fields.
• Legacy queries: Removed nauticalApp, nauticalApps, and externalNotificationTrigger queries.

If you were using any of these features, please contact support for migration guidance.

Base amount money field for better accuracy​

Added a baseAmount field to all money-related objects (Money, MoneyRange, TaxedMoney). This field represents the monetary value in the smallest unit of the currency, offering greater accuracy over the existing amount floating point field.

For example, in currencies with two decimal places like USD, $12.45 will be represented as baseAmount=1245.

The amount field is now deprecated and will be removed in 6 months.

Allow buyer to query suborders​

A buyer can now query me.NauticalOrder.subOrders for the seller order information. Payout-related fields on the seller order will not be visible to the buyer.

Seller ID on multi seller shipping method​

Added the sellerId field to the MultiSellerShippingMethodtype.

Improved webhook logging​

Added webhook logging for request time outs and connection errors.

Fixed an issue where duplicate transaction records could be created against the same Stripe payment intent. This did not affect the actual payment captured by Stripe.

Deprecated money fields​

The amount and localized fields on the money type have been deprecated and will be removed after a deprecation period.

Removed dummy_credit_card payment gateway​

Removed the dummy_credit_card payment gateway. All test payments should be done through the dummy gateway going forward.

Removed RazorPay payment gateway​

Removed the RazorPay payment gateway.

Removed gift card model​

Removed the GiftCard model, including all related queries and mutations.

Buyer access to sub-orders​

Buyers can now view sub-orders within their marketplace orders, providing better visibility into how their purchases are fulfilled across multiple sellers.

Order search by product variant SKU​

Added support for searching orders by grouped product variant SKU, making it easier to find orders containing specific product variants.

Seller identification in shipping methods​

The MultiSellerShippingMethod GraphQL type now exposes the seller's GraphQL ID, providing clearer seller attribution for shipping options.

Currency display improvements​

Added base_amount currency values to queries, providing more consistent currency formatting and display across the platform.

Payment gateway updates​

• Renamed the "Dummy Gateway" to "Test Payments" for clarity.
• Removed the legacy dummy_credit_card gateway.
• Removed the non-functional Razorpay gateway integration.

Fixed an issue where shipping voucher discounts were not being applied correctly during checkout.

Separated the NauticalDraftOrderCreate and NauticalOrderUpdate mutations to prevent conflicts and ensure draft orders are created correctly.

Fixed a race condition in Stripe webhook processing by properly locking checkout and nautical order records during payment updates.

Improved transaction handling in checkoutPaymentCreate to ensure payment records are created atomically.

Improved error logging for webhook deliveries, now capturing timeout and connection errors for better debugging.

Fixed an issue where fulfillment webhooks were failing in the Shopify plugin integration.

Added a proper deprecation notice for the Money.amount field to guide developers toward the correct currency handling approach.

Gift card support removed​

Removed gift card functionality from checkouts, orders, and user accounts. This includes:

• Gift card queries and mutations
• Gift card payment methods
• Gift card refund options

Order line item notes​

Added the ability to add a note per order line item. The following mutations have been added to add line-level notes:

• checkoutLineAddNote: Adds a note to a CheckoutLine.
  note

  When the checkout is converted to an order, any CheckoutLines are converted to NauticalOrder and Order lines.

• nauticalOrderLineAddNote: Adds a note to a NauticalOrderLine.
• orderLineAddNote: Adds a note to an OrderLine.

Learn more ->

New locations queries​

Added the locationSearch and locationGeocode queries, to replace the deprecated mutations.

Email payloads with order line item thumbnails​

Added the original.url field to images on order line items for SendGrid email payloads. This new field provides the URL of the unprocessed, original image, facilitating the integration of image thumbnails in dynamic email templates.

This update provides a way around the SendGrid limitation with accessing the sized thumbnail URLs, which were previously available but incompatible with SendGrid handlebars.

Validation error when payment token already used​

Added a validation error for instances where a token has already been used for a payment.

Sort products or variants by brand or manufacturer​

Added the ability to sort products or variants by the brand and manufacturer fields.

Deprecated location mutations​

The locationSearch and locationGeocode mutations have been deprecated. Instead, use the new locations queries.

Deprecated secondary address​

Deprecated the ShippingMethod.requiresSecondaryAddress and secondaryAddress fields, which were non-functional.

Deprecated shipping fields​

The checkout.shippingMethod and nauticalOrder.shippingMethodName fields have been marked deprecated. These fields were not functional as shipping is stored on the seller order (order).

Removed NauticalFulfillment model​

The following models have bee removed, as fulfillments are tracked at the seller order level.

• NauticalFulfillment
• NauticalFulfillmentLine

This change has been made backwards-compatible. To keep backwards compatibility for NauticalOrder.fulfillments, the type of that field is changed to Fulfillment but the resolver is changed to an empty list.

Removed connection between seller order and payments​

Removed the connection between seller orders (order) and payment objects. This connection had already logically been empty since the deprecation in version 1.9.

As a result, any existing logic querying orders must not explicitly include payments.

Removed taxRate field from order lines​

The taxRate field has been removed from the NauticalOrderLine and OrderLine objects.

Removed nauticalSuborders query​

The nauticalSuborders query has been removed.

Notes on order lines​

Added the ability to include custom notes on individual order lines, providing more flexibility for capturing line-level details and instructions.

Original image URLs in email payloads​

Email notifications now include the original image URLs for products, making it easier to display high-quality product images in custom email templates.

Sort products by brand and manufacturer​

Added support for sorting products and variants by brand and manufacturer, making it easier to organize and browse large product catalogs.

Improved shipping method handling​

Simplified how shipping methods are managed for marketplace orders, improving reliability and making it easier to update shipping information after an order is placed.

Internal data structure improvements​

Updated several internal data structures to improve consistency and maintainability across the platform. These changes are transparent to API consumers.

Fixed an issue where payment webhook race conditions could cause inconsistent order states when multiple payment events occurred simultaneously.

Improved error messages when attempting to create duplicate authentication tokens, making it clearer what action needs to be taken.

Fixed an issue where the seller order status could be incorrect when checking if a seller is the only seller on a marketplace order.

Fixed an issue where webhook payloads could serialize date fields incorrectly, ensuring consistent date formatting across all webhook events.