Delete Partner Sale

Description

This service allows an authenticated partner to delete a specific sale record.

Important Identification Note: The sale must be identified by the Thalamus Sale ID, not by your internal partner transaction/sale ID.

---

Request

Restrictions

• Authentication: Requires a successful partner login.

• Authorization: The sale record must belong to the logged-in partner.

Endpoint

DELETE https://<server-url>/api/v4/partner/sale/{sale_id}

Path Parameters

Parameter	Type	Description
sale_id	Integer	The unique Thalamus ID of the sale to be deleted.

Parameters

Parameter	Location	Description
touchpoint	Query / Header	The identifier for the touchpoint. Use Thalamus-Touchpoint for the header.
token	Query / Header	The authentication token for the partner session. Use Thalamus-Token for the header.

Full URL Example

https://<server-url>/api/v4/partner/sale/17895?touchpoint=test&token=...

---

Response

✅ Successful Response: 200 OK

The sale record has been successfully removed.

JSON

{
	"message": "OK"
}

---

❌ Unsuccessful Response

400 Bad Request

The following errors may be returned in the errors object:

Error Code	Field	Description
InvalidRoleForLoggedParty	partner	The authenticated user does not have the "Partner" role.
notFound	saleId	The specified sale_id does not exist in the system.
cannotDelete	saleId	The sale cannot be deleted (e.g., it may be locked, already processed for billing, or outside the allowed deletion window).