---
updatedAt: 2026-10-29T08:22:22.000Z
agentTools:
  projectIndex: https://docs.yotpo.com/llms.txt
---

# Testing your integration

How to test against Yotpo without touching real shoppers, which calls have side effects, and a checklist before you go live.

The Yotpo APIs have no sandbox or test mode. Every request reaches a real Yotpo store, including requests sent from **Try It** on the reference pages, which use whatever store ID and token you enter.

## Use a separate store

* **Merchants and agencies:** test against a Yotpo store you keep only for testing, with its own store ID and API secret. To get one, ask your Yotpo contact (your account manager or Yotpo support).
* **App partners:** build and test against the Yotpo test account you opened when you [registered your app](https://docs.yotpo.com/docs/registering-a-new-app). Install your app on it through the normal install flow, so you test the same OAuth steps a merchant goes through. Never test against a merchant's live store without their agreement.

Don't test against a live store:

* Orders and fulfillments can trigger review request emails to the email address on the order.
* Products, orders and customers can't be deleted through the API, so test data stays in the store.
* Some calls change what shoppers see, such as publishing reviews or adjusting loyalty points.
* Test traffic uses the same rate limit as live integrations.

Keep store IDs, secrets and access tokens in configuration or a secrets store, not in code, so you can switch from the test store to the live one without changing code.

## Calls that are safe to repeat

These only read data:

* All `GET` requests, for example [Retrieve orders](https://docs.yotpo.com/reference/retrieve-orders), [Retrieve products](https://docs.yotpo.com/reference/retrieve-products) and [Retrieve customers](https://docs.yotpo.com/reference/retrieve-customers).
* [Generate access token](https://docs.yotpo.com/reference/yotpo-authentication). Each call returns a token; it doesn't change the store.
* All storefront endpoints on `api-cdn.yotpo.com`, including the review search endpoints that use `POST`.
* [Best Reviews](https://docs.yotpo.com/reference/best-reviews) and [Best Sentences](https://docs.yotpo.com/reference/best-sentences), which use `POST` to pass filters but only read.
* [Product Potential Points](https://docs.yotpo.com/reference/get-product-potential-points), which uses `POST` but only calculates.

## Calls with side effects

| Endpoint                                                                                                                                                                                                                                                            | What happens                                                                                                                                                                                      | How to test it safely                                                                                                                                                                                          |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Create order](https://docs.yotpo.com/reference/create-order), [Update order](https://docs.yotpo.com/reference/update-order), [Create order fulfillment](https://docs.yotpo.com/reference/create-order-fulfillment), [Update order fulfillment](https://docs.yotpo.com/reference/update-order-fulfillment), [Send aggregated order info](https://docs.yotpo.com/reference/send-aggregated-order-info)                | Adds or changes the order. Once it has a fulfillment with `status: success`, Yotpo can send a review request email to the order's customer. Orders can't be deleted.                              | Use `example.com` email addresses only. To keep a test order out of review requests, set `custom_properties.suppress_review_request` to `true`.                                                                |
| [Create product](https://docs.yotpo.com/reference/create-product), [Create product variant](https://docs.yotpo.com/reference/create-product-variant), [Create collection](https://docs.yotpo.com/reference/create-collection)                                                                                                                              | Adds catalog entries. They can't be deleted through the API. Send aggregated order info also creates products that don't exist yet.                                                               | Use clearly named test products in the test store. To retire one, [update it](https://docs.yotpo.com/reference/update-product) with `is_discontinued: true`.                                                                                |
| [Create or update customer](https://docs.yotpo.com/reference/create-customer)                                                                                                                                                                                                                    | Creates or updates a customer profile. Customers can't be deleted through the API.                                                                                                                | Use `example.com` email addresses and `external_id` values you can recognize.                                                                                                                                  |
| [Publish/Unpublish Reviews](https://docs.yotpo.com/reference/publishunpublish-reviews), [Create New Comment](https://docs.yotpo.com/reference/comment-on-a-review), [Update Existing Comment](https://docs.yotpo.com/reference/update-a-comment-on-a-review-1), [Delete Comment](https://docs.yotpo.com/reference/delete-a-comment-on-a-review), [Vote on answers](https://docs.yotpo.com/reference/vote-on-answers) | Changes which reviews, comments and vote counts shoppers see.                                                                                                                                     | Use test reviews and answers only.                                                                                                                                                                             |
| [Adjust Loyalty Customer Points](https://docs.yotpo.com/reference/adjust-loyalty-customer-points), [Record Loyalty Customer Action](https://docs.yotpo.com/reference/record-loyalty-customer-action)                                                                                                                          | Changes the customer's points balance and history. The resulting loyalty events can reach the merchant's other tools, such as email or SMS flows.                                                 | Use test customers with `example.com` addresses, and small amounts.                                                                                                                                            |
| [Create subscription](https://docs.yotpo.com/reference/create-subscription) (and the app partners [store subscription](https://docs.yotpo.com/reference/partners-create-subscription))                                                                                                                                        | An active subscription sends the store's real events, including shopper data, to the target URL. A target that a subscription uses can't be deleted until you delete or update that subscription. | Point targets only at endpoints you control. Create subscriptions with `active: false` until your endpoint is ready, and [delete](https://docs.yotpo.com/reference/delete-subscription) test subscriptions, filters and targets afterwards. |
| [Delete target](https://docs.yotpo.com/reference/delete-target), [Delete filter](https://docs.yotpo.com/reference/delete-filter), [Delete subscription](https://docs.yotpo.com/reference/delete-subscription)                                                                                                                                              | Permanently removes the webhook object.                                                                                                                                                           | Delete only objects you created for the test.                                                                                                                                                                  |
| [Remove Application](https://docs.yotpo.com/reference/remove-application) (app partners)                                                                                                                                                                                                         | Deletes the app's access token. The merchant has to install your app again before you can call their store.                                                                                       | Use it on your test account to test your uninstall flow, then reinstall.                                                                                                                                       |

V1 calls have the same effects: [Create order](https://core-api.yotpo.com/v1.0/reference/create-an-order-within-the-yotpo-system-metadata) and Create mass orders add orders that can trigger review requests, and Create or update mass products emails a report to `return_email_address`.

## Test data rules

* Use `example.com` email addresses. The domain is reserved, so mail sent there is never delivered. When you need to receive an email, use an inbox you own. Never use real customers' names, emails or phone numbers.
* Give test objects recognizable IDs, for example an `external_id` that starts with `test-`, so you can find them later with the `external_ids` filter.
* Keep a list of everything you create (products, orders, customers, comments, point adjustments, webhook objects) so you can clean up what can be cleaned up.
* Create products before orders: an order whose line items refer to an unknown product returns `404` (see [Errors](https://docs.yotpo.com/docs/error-handling)).
* Storefront endpoints return `200` with no reviews for an unknown product ID (see [Errors](https://docs.yotpo.com/docs/error-handling#storefront-endpoints)), so a typo looks like "no reviews yet". Use product IDs that exist in the test store.

## Rate limits apply during tests

Test traffic counts against the same limits as live traffic: 5 requests per second per store on `api.yotpo.com`. Run load tests against the test store, never the live one, and handle `429` responses as described in [Errors](https://docs.yotpo.com/docs/error-handling#429-too-many-requests).

## Before you go live

* [ ] Your API secret, app secret and access tokens are used only on your server and never reach the browser.
* [ ] Your code requests a new store token after a `401` and retries once. App partners: you store one token per store, and after 3 `401 invalid_token` responses in a row you show the integration as disconnected and let the merchant reinstall.
* [ ] Your code waits on `429` (using `Retry-After`), retries reads on `5xx`, and treats a `409` on a retried create as success.
* [ ] The live store ID and API secret come from configuration.
* [ ] Product, order and customer `external_id` values match the IDs your platform uses.
* [ ] Orders send real customer emails only in the live store, and test orders never reach it.
* [ ] Webhook targets point at your production endpoint, your endpoint answers quickly with `200` and ignores duplicate deliveries (see [About webhooks](https://docs.yotpo.com/docs/about-webhook-events)), and test subscriptions are deleted.
* [ ] App partners: merchants can uninstall from your product ([Remove Application](https://docs.yotpo.com/reference/remove-application)) and from Yotpo (the [App Disconnected](https://docs.yotpo.com/reference/app-disconnected) event). Then [certify and launch your integration](https://docs.yotpo.com/docs/certifying-and-launching-your-integration).

# Sibling pages

* [What you can build](https://docs.yotpo.com/docs/what-you-can-build.md)
* [How to use the Core API](https://docs.yotpo.com/docs/how-to-use.md)
* [Guidelines & conventions](https://docs.yotpo.com/docs/guidelines-and-conventions.md)
* [App key vs. Store ID](https://docs.yotpo.com/docs/store-id-app-key.md)
* [Rate limiting](https://docs.yotpo.com/docs/rate-limiting.md)
* [Errors](https://docs.yotpo.com/docs/error-handling.md)
* [Idempotency](https://docs.yotpo.com/docs/idempotency.md)
* [Working with entity identifiers](https://docs.yotpo.com/docs/working-with-entity-identifiers.md)
* [Working with custom properties](https://docs.yotpo.com/docs/working-with-custom-properties.md)
* [Connect to Yotpo's MCP Servers](https://docs.yotpo.com/docs/connect-to-yotpo-mcp.md)