The Merchant API features a DELETE endpoint designed primarily for removing test merchant data from your platform. To prevent accidental data loss, safeguards are in place that prevent the deletion of merchants with associated transactions or payment method tokens.

If a merchant has no linked transactions or tokens, the record will be successfully deleted, and an HTTP status code of 204 will be returned.

Here is a summary of potential scenarios and their corresponding responses:

ScenarioHTTP StatusError Message
No transactions or tokens204None
Has associated transactions400Merchant has associated transactions and cannot be deleted
Has associated tokens400Merchant has associated tokens and cannot be deleted
Click Try It! to start a request and see the response here!