Marketplace recipes

Marketplace recipes are guided, step-by-step workflows for common Marketplace integration scenarios. Each recipe combines implementation guidance, ready-to-run code samples, and validation checkpoints to help you complete a workflow and verify the expected results.

Recipes walk you through the required APIs in the order they should be called and include sample requests, validation checkpoints, and links to related documentation. Examples include order fulfillment, returns and refunds, and inventory management.

A recipe is a structured guide for validating a specific Marketplace scenario. Whether you're validating order fulfillment, processing returns and refunds, or managing inventory, recipes walk you through the required APIs in the order they should be called and provide the guidance needed to complete each workflow.

How to use a recipe

Start with the recipe that matches the workflow you want to test. Review the prerequisites, then complete each step in order. Each step includes the endpoint, requirements, sample request, and expected result.

Every recipe includes:

• Step-by-step guidance for completing a Marketplace workflow
• Copy-ready code samples in cURL, Python, and Java
• Validation checkpoints to verify expected behavior
• Related guides and API references for additional information

Using the code samples

The sample requests are designed to be copied and adapted for your sandbox environment. Replace the placeholder values with the resources generated during your workflow or your own sandbox resources before sending the request.

Common placeholders include:

• {{token}}
• {{sku}}
• {{purchaseOrderId}}
• {{returnOrderId}}
• {{shipNode}}

Dynamic sandbox recipes

The Dynamic sandbox is a self-service testing environment where you can create test data and validate end-to-end Marketplace workflows without affecting production. Use these recipes to test common scenarios and verify expected results.