Affiliates
Delete Affiliate
Learn how to delete an affiliate using the DELETE /stores//affiliates/ endpoint.
DELETE
Delete affiliate
📌 Endpoint
DELETE /stores/{storeId}/affiliates/{affiliateId}
Removes an affiliate from the store (soft delete). The affiliate disappears from listings, but the record remains in the database for safety — including commission resolution no longer considers it.
Requirement: The affiliate must be paused (status: "inativo") for at least 7 days before it can be deleted. Otherwise, the API returns400(AFFILIATE_NOT_PAUSEDorAFFILIATE_PAUSE_PERIOD_NOT_ELAPSED).
🔐 Authentication
- Private route.
- Requires the
Authorizationheader with your API key and an active plan.
🧾 Route parameters
✅ Request example
📦 Success response (200)
⚠️ Possible errors
400 INVALID_DATA→ invalid parameters400 AFFILIATE_NOT_PAUSED→ the affiliate must be paused (status: "inativo") before deletion400 AFFILIATE_PAUSE_PERIOD_NOT_ELAPSED→ the affiliate must remain paused for at least 7 days401 API_KEY_NOT_PROVIDED→Authorizationheader not provided401 INVALID_API_KEY→ invalid API key401 UNAUTHENTICATED→ unauthenticated user403 USER_DISABLED→ user disabled403 NO_ACTIVE_SUBSCRIPTION→ no active plan404 STORE_NOT_FOUND→ store not found404 AFFILIATE_NOT_FOUND→ affiliate not found429 RATE_LIMIT_EXCEEDED→ per-minute rate limit exceeded500 INTERNAL_SERVER_ERROR→ internal server error503 SERVICE_UNAVAILABLE→ service unavailable