2024 latest
Commerce API release notes for 2024.
Last updated
Was this helpful?
Commerce API release notes for 2024.
Last updated
Was this helpful?
We are excited to introduce significant enhancements to our Cancel Subscription API with the addition of two new parameters: cancelReasonCode and cancelComment. These updates aim to provide better tracking, analytics, and a richer context for subscription cancellations. For more information, see:
Shopper APIs:
Admin APIs:
In our continuous effort to provide comprehensive tools for developers and testers, we are pleased to introduce new test credit card numbers. These numbers facilitate the evaluation of various payment-related success and error scenarios more efficiently. See for a detailed overview of the new test card numbers along with their intended use cases:
We strongly recommend using these specific test credit card numbers in your testing routines to ensure thorough validation of your payment integrations. This update improves the reliability and robustness of your payment processing systems, providing a smoother experience for developers and end-users.
We're excited to share a significant update to enhance the shopping and gifting experience for retailers and their customers. The popular Gift Messaging feature, previously available exclusively in the Global Commerce-hosted solution, has now been seamlessly integrated into the Commerce API.
The Commerce API now supports gift messaging, leveraging the existing Global Commerce settings. This update allows shoppers to add personalized messages to their gift orders, making each gift even more special and memorable.
Enhanced gifting options: Retailers can now offer their customers the capability to send personalized messages with their gifts by activating the gifting option for sites and products. This feature can be easily enabled when creating or editing a product listing.
Improved communication: Depending on whether the product is physical or digital, the system can send tailored notification emails to both the purchaser and the gift recipient, ensuring clear and timely communication.
Personalized messages: For an added personal touch, gift messages are included on the gift invoice for physical products or in the email notification for digital products, providing a more personal and thoughtful gifting experience.
Incorporating gift messaging into your Commerce API is straightforward for those already using the Global Commerce-hosted solution and will significantly enhance your customers' shopping experience.
To send a gift from a Global Commerce-hosted checkout.
Select the Send as a gift checkbox.
Complete the required fields, including the recipient's first name, last name, email, and gift message.
Submit the cart to place the gift order.
API users can send an API request.
Set giftInfo.enabled = true.
Enter a personal message for the gift in giftInfo.message.
Enter the recipient's first name, last name, and email address in the shippingAddress object.
For more information, see:
Should you have any questions or require further assistance, contact the Commerce Product Team. We're here to help you leverage this new feature to delight your shoppers and make gift-giving a breeze.
Stay tuned for more updates, and thank you for being a part of our community. Happy gifting!
We are excited to announce a new feature that adds flexibility to your subscription management capabilities: the Prorate Non-subscription Child Products along with the Parent Product toggle!
This new functionality allows you to maintain transparency and accuracy in subscription management like never before. It provides the option to include or exclude non-subscription child products from proration when adjusting the parent subscription plan.
Imagine this scenario: You're signing up for an online streaming service. Your annual subscription plan for unlimited streaming is priced at $120 annually. The subscription comes bundled with a one-time Setup Assistance service for $30, which helps you set up your account and devices.
Let's say you initially subscribed to the streaming service in January. In June, you decide to upgrade to a family plan, adding one more streaming device to your subscription for bedroom viewing. With the proration toggle set to OFF, the system calculates the prorated price for the upgraded family plan from June to December ($120 * 6/12 = $60) but keeps the one-time Setup Assistance service price fixed at $30.
Set the toggle to OFF when you have bundled services like a one-time Setup Assistance service and want to upgrade or change your subscription plan. The price of the Setup Assistance remains unchanged, ensuring that you bill the one-time services appropriately.
Set the toggle to ON when you want the subscription and any additional bundled services or products (e.g., warranties, add-ons) to be adjusted in price and prorated together. It ensures a seamless adjustment to pricing whenever you make changes to your subscription.
Flexibility: Customize how you bill bundled products or services during subscription plan changes.
Accuracy: Ensure you reflect accurate pricing for the parent subscription and any associated child products or services.
Simplicity: Managing subscription plans is now more straightforward, with clear, controllable billing adjustments.
If you have any questions or require assistance, contact the Commerce Product Team.
In our latest update, we've significantly improved and added to our error-handling mechanisms. These changes provide developers with more specific and actionable feedback, making your work easier and more efficient and enhancing overall system robustness and reliability.
We added the following 409 Conflict error codes:
We added the following synchronous response error codes.
These updates are part of our ongoing efforts to improve the developer experience and system usability. We appreciate your feedback and are here to support your integration efforts with our platform.
In our continuous effort to improve the clarity and usability of our API documentation, we are pleased to announce some significant updates in our latest release:
We've reorganized our subscription documentation. The section is now more comprehensively divided into two main subsections:
We're excited to announce the latest updates to our Admin API, making the management of offers even more seamless and efficient. Enhancing your ability to provide value and flexibility to your customers has always been our priority. Here's what we've rolled out:
Create offer: We are working on the ability to update coupon code offers. Stay tuned for future releases!
Try out these new enhancements today!
These updates are part of our ongoing efforts to support and empower the developer community with the tools and knowledge to create seamless post-order communication experiences.
Current Clients: Rest assured, no action is required from your end. This update does not impact clients who have already registered their domains with Apple Pay. Your services will seamlessly continue to operate without any disruption.
New Clients: This update applies to registering domains with Apple Pay. We advise new clients to follow the updated registration process to ensure a smooth integration.
allowShippingCountries: Specify the countries you want to allow shipping by listing their two-letter country codes. Only addresses associated with these countries will be available as shipping destinations in the Amazon Pay wallet.
Note: If a country code appears in both allowShippingCountries and denyShippingCountries, the allow list takes precedence, ensuring the country is available for shipping.
denyShippingCountries: List the two-letter country codes of the countries you want to deny shipping. These addresses associated with these countries will not appear as selectable options in the Amazon Pay wallet.
In this exciting release, you can leverage the brand-new Offer Admin API to create specific offer triggers with offer types. Plus, deploying the created offer is easier than ever, all through the Offer Admin API!
Here's what we support in this initial release:
Do you want to associate the offer with your offer system? We've got you covered! We also included support for an External Reference Offer ID.
But wait, there's more! Stay tuned for additional Offer Admin API support in future releases.
Enhance your offer management capabilities and stay ahead of the game with the Offer Admin API. Don't miss out – try it today!
Unlock advanced offer management with our new Offer Admin API! 🚀
Detailed Implementation Steps: Step-by-step instructions to guide you through the PON integration process.
Event Triggers Explained: An in-depth look into various events that can trigger post-order notifications, ensuring you have the control to customize your customer's journey.
Best Practice Recommendations: Insights and recommendations on using PON to boost customer satisfaction and loyalty.
We believe this guide will be invaluable in enabling more engaging and informative communication with your customers post-purchase.
We've got fantastic news for our commerce platform users! We're thrilled to introduce three new webhook events to streamline inventory management.
Now, managing your inventory is even more efficient with these new webhook events:
These new webhook events empower you to stay on top of your inventory levels and respond promptly to changes. Never miss a beat in inventory management – try them out today!
Experience streamlined inventory management with our enhanced webhook events! 🚀
Exciting news! Managing Personal Identifiable Information (PII) removal became even easier with our Admin API solution!
Customer Admin API requests:
Order Admin API requests:
Simplify your data management – give it a try today!
Send a request with the following details to set up a gift order:
to finalize the gift order.
To start leveraging this new feature, we invite you to follow the instructions for . This resource will help you understand the feature in detail and implement it effectively.
: This error code appears when the provided payment source is invalid or cannot be processed. Ensure the payment source details are correct and try again.
: This error appears when a user attempts to create a resource that already exists. It prevents duplicate entries and maintains data integrity.
: This error indicates the customer's external reference ID{externalReferenceID} is not unique on the site. It ensures that each resource remains unique.
: This error is returned when the subscription ID does not match existing subscriptions. Verify the subscription ID and try again.
: This error message indicates that the system could not find the specified order. Ensure the order ID is correct and exists within the system.
We renamed the section formerly known as Common Shopper and Admin APIs to . This change aims to provide a clearer understanding of the APIs' functionalities and to ensure a more intuitive navigation experience.
: This section provides a broad overview of our subscription capabilities in the Shopper APIs.
: Here, users will find detailed instructions on managing subscriptions, covering everything from creation and modification to cancellation processes in the Admin APIs.
: Access the most recent version of any offer with the new endpoint GET /v1/offers/{offerID} to ensure you're always working with the latest information.
: Stay on top of your offer edits with the ability to track the latest deployed offer via GET v1/offers-api/offers/{offerId}?version=deployed. This feature helps in ensuring consistency across your promotional activities.
: Clean up your active promotions by easily retiring outdated offers using POST /v1/offers/{offerId}/retire. Keep your promotions relevant and engaging for your customers.
: We optimized the entire process from creation to retirement of offers for smoother integration and management through your existing systems.
We're thrilled to unveil the latest enhancements to our . These new features elevate the developer experience and streamline post-order communications, offering you more control and efficiency. Here are the key updates:
: As part of our commitment to providing comprehensive resources, we've introduced detailed payload examples for various post-order notifications. These examples, meticulously crafted for order confirmations, shipping updates, and delivery statuses, will give you a deep understanding of the required structure and content for crafting effective notifications across different scenarios.
: Understanding the importance of timely and relevant order updates, we've unveiled a new section dedicated to order event notifications. This section provides comprehensive descriptions and examples of event triggers, empowering developers to fine-tune their notification systems to respond to specific order milestones accurately and efficiently.
In our continuous effort to enhance our services and security, we have updated the apple-developer-merchantid-domain association for . This change is part of our ongoing updates to ensure a seamless and secure payment process for all our users.
We're excited to announce new features in our Amazon Pay integration that aim to enhance the checkout experience for you and your customers. With these updates, you can specify shipping preferences directly within the , offering clearer communication and streamlined checkout processes. Below are the details of the newly released features:
For more detailed information on configuring these new features in your Amazon Pay integration and insights into the broader capabilities of the Amazon Pay element, refer to the and sections. This resource provides comprehensive guidance on optimizing your checkout experience using the latest features.
With our , you can determine a pricing strategy for a subscription product combination in . These pricing scenarios explain how price settings affect the subscription renewal price.
Big news for our Global Commerce platform users! We're happy to announce the latest addition to our Admin API family – the !
for a trigger such as a "Promotional URL" and a discount type such as "Discount," allowing you to tailor your offers to suit your promotional needs precisely.
: Seamlessly deploy your offers with just one call.
We are thrilled to announce the release of the . This comprehensive guide provides developers and businesses with the necessary tools and knowledge to seamlessly integrate post-order notifications into their systems, enhancing the post-purchase experience for customers across the board.
: Receive instant notifications when your inventory runs out of stock, ensuring you're always aware of stock shortages.
: Stay informed about any updates made to your self-managed inventory, keeping you in the loop with real-time changes.
: Get notified when there are updates to your fulfiller-managed inventory, ensuring seamless coordination with your suppliers.
You could always from ; in our latest enhancement, you can now seamlessly via the API solution using a customer ID (shopper ID) or an order ID to initiate the request. If a user has previously asked to be forgotten, the responses for the following requests will display the PII removal request timestamps.
Gaqvy1
Good news! Managing Product Combinations just got easier. With our latest enhancement, you can —create, read, update, and remove product combinations using the original Excel or XML BPU function. Simplify your workflow and check it out today! 🚀
