The Delete Merchant endpoint permanently removes a merchant and all associated data. This action is irreversible — balances, invoices, API keys, and settings tied to the merchant will no longer be accessible after deletion.
DELETE /merchants/{merchantID}
Deleting a merchant is permanent. Ensure you have withdrawn all remaining funds and that no active integrations depend on this merchant before proceeding.
Authentication
Accepts a Bearer token (Authorization: Bearer <token>) or an API key (X-Api-Key: <key>).
Path parameters
The UUID of the merchant to delete.
Response
Returns 204 No Content with no response body on success.
Example request
curl --request DELETE \
--url https://api.iterapay.com/merchants/b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f \
--header 'Authorization: Bearer <token>'
Example response
Error responses
| Status | Description |
|---|
401 | Missing or invalid credentials. |
403 | Valid credentials but insufficient permissions. |
404 | No merchant found with the given merchantID. |
