Tutorial
In this tutorial, you'll understand how to use Rye's cart API to create a cart, add products to it, and submit it for checkout.
Requirements
- You have created a Rye Developer Account.
- You have access to your API key (Follow these steps if not).
- Skip Steps 1 - 3 if you have completed the Product API tutorial.
Step 1: Initialize GQL client with your API key
Use your API Key to initialize authorization headers for your GQL client.
Step 2: Add external product to Rye inventory
Adding product data to inventory may take a few seconds, but the product id will be returned immediately. You can then use this product id to fetch product data in the next step.
You can also do this via the Rye Console.
Step 3: Fetch product data from Rye inventory
The product ID can be found in the response to the requestProduct
mutation.
Step 4: Create a cart
Create your first cart! We don't require adding a product for the cart to be created if you'd like to create an empty cart.
Step 5: Add more products to your cart
Add more products to your cart with the productIDs and the cartID for the cart that you'd like to add your products to.
Step 6: Verify your cart details
Check if your cart looks good and has the products you have added to it.
Step 7: Update buyer identity
Update buyer identity information if it was not provided during cart creation as it is required to be able to submit the cart.
Step 8: Submit your cart
Submit your cart via rye-pay and Spreedly iFrame.
Step 9: Display the results of the transaction
The result of theryePay.submit
should return the cart data and any possible errors that occurred during the submission of the cart. Errors can occur on the Cart level and the Store level:
- For the cart level:
result.errors
will provide an array of errors related to submitting the cart with appropriate error messages and codes - For the store level:
result.cart.stores[idx].errors
will provide an array of errors related to submitting the order to the store with appropriate error messages and codes
(Optional) Step 10: Cart management
- To update the number of existing products in the cart, use the
updateCartItems
mutation. - To remove existing products from the cart, use the
deleteCartItems
mutation. - To remove the entire cart, use the
removeCart
mutation.
Next steps
- Check out the documentation to start using the Cart API
- Run queries on the GraphQL on either of the following playgrounds:
- https://docs.rye.com/graphql
Ensure you have the HTTP headers set
Before testing on https://docs.rye.com/graphql, you will need the correct HTTP headers. Check this guide here on how to get them.
- https://console.rye.com/graphql
- https://docs.rye.com/graphql
Updated 4 days ago