Delete Terminal

Remove a terminal that you no longer need (for example, a device de-commissioned in the field or a test terminal created during integration).

Deleting a terminal is irreversible. All payment history remains intact and can still be queried through the Reporting APIs, but the terminal itself can no longer accept new payments or webhooks.

Endpoint

DELETE https://api.test.devs.beadpay.io/Terminals/{id}

Required header

Name	Example	Notes
Authorization	Bearer eyJhbGciOiJS...	Same access token used for other Terminal Management calls.

Path parameter

Name	Type	Description
id	string	The terminal identifier you want to delete (16-byte value returned by Create Terminal or List Terminals).

Request example

curl -X DELETE \
  "https://api.test.devs.beadpay.io/Terminals/2352354" \
  -H "accept: */*" \
  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"

(There is no request body.)

Response codes

HTTP status	Meaning	Body
204 No Content	Terminal deleted successfully	Empty
404 Not Found	Terminal id is unknown or already deleted	{ "code": "TerminalNotFound", "message": "Terminal 2352354 does not exist." }
409 Conflict	Terminal cannot be deleted because it is still active (e.g., open sessions)	{ "code": "TerminalActive", "message": "Terminal 2352354 has active sessions and cannot be deleted." }
401 Unauthorized / 403 Forbidden	Invalid or expired access token	Standard auth error payload

Usage tips

• Clean up test data – Call this endpoint in your CI pipeline to remove temporary terminals created during automated tests.

• Device retirement – Delete a terminal when the physical device is de-commissioned so it no longer appears in List Terminals responses.

• Safety checks – Attempting to delete a terminal that still has an open payment session will return 409 Conflict; close sessions first or wait until they settle.

Related operations

Operation	Description
Create Terminal	Add a new device to your account.
List Terminals	Retrieve all active terminals.
Update Terminal Webhook	Configure or change the payment-status webhook URL for a terminal.

Add this page under Terminal Management → Delete Terminal, or whichever naming convention you’re using for the endpoint pages.