> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joinmarkt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Setup Shopify

> Accept payments through Shopify hosted checkout on Join Markt.

# Setup Shopify

Join Markt can hand buyers to Shopify checkout and settle via webhook.

## Routes

| Route                             | Role                                 |
| --------------------------------- | ------------------------------------ |
| POST /api/shopify/create-checkout | Create Shopify checkout for an order |
| POST /api/shopify/verify-payment  | Verify after return                  |
| POST /api/shopify/webhook         | Settlement                           |

## Setup

1. Connect Shopify credentials in Payment methods.
2. Register the webhook URL: `https://YOUR_APP_ORIGIN/api/shopify/webhook`.
3. Run a test purchase and confirm order status becomes paid/completed.

## Notes

* Which products show Shopify depends on store payment config.
* Treat webhook HMAC/signature verification as mandatory.
* Fulfillment still runs through Join Markt delivery after `completeOrderFromGateway`.
