delete
https://sandbox-api-gtw.softpoint.io/api/locations//ach/tokens/
Permanently removes an ACH token and its associated bank account data from the system.
Request Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer YOUR_ACCESS_TOKEN |
| Content-Type | Yes | application/json |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
location_id | string | Yes | Identifier of the location that owns the token |
token | string | Yes | The ACH token to be deleted |
Request Body
No request body is required for this endpoint.
Response
200 — Success
{
"status": "approved",
"message": "ACH account deleted successfully"
}Response Fields
| Field | Type | Description |
|---|---|---|
status | string | Result status (approved on success) |
message | string | Human-readable confirmation message |
404 — Token Not Found
Returned when the specified token does not exist or does not belong to the given location.
{
"error": {
"code": 1234,
"name": "ach_generic",
"message": "ACH token not found",
"details": []
}
}400 — Processor Error
Returned when the underlying processor fails to delete the account.
{
"error": {
"code": 1234,
"name": "trx_error",
"message": "Error deleting ACH account",
"details": []
}
}Notes
- Deletion is permanent and cannot be undone.
- Any future transaction attempts using the deleted token will fail.
- Not all processors support token deletion. A
400 Bad Requestwithtrx_errormay indicate that the processor does not allow this operation. Get smarter responses, upload files and images, and more.