API v1.16

Dec 7, 2023: Staging

Jan 15, 2024: Production

✨ New

Orders

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 ->

Payments

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 ->

Vendor mgmt

Sort sellers by creation date

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

💎 Changed

Webhooks

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 ->

Catalog

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.

Payments

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.

Integrations

Version for plugins

Added the version field to the plugins model.

🪲 Fixed

Integrations

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

Payments

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

Checkout

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

🚫 Deprecated

Integrations

Removed VATLayer plugin

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

Payments

Removed purchase order plugin

The purchase_order payment gateway has been removed.

Payments

Removed credit limits model

Removed the CreditLimits model, which was not in use.

Webhooks

Removed invoice webhooks

Removed invoice webhooks, which were not in use.

Designer

Removed translations

Removed the translation model.

Permissions

Removed deprecated permissions

Removed the manage_gift_cards and manage_credit_limits permissions.