/processing-terminals/{processingTerminalId}/secure-tokens/{secureTokenId}deleteSecureTokenUse this method to delete a secure token and its related payment details from our vault.
To delete a secure token, you need its secureTokenId, which you sent in the request of the Create Secure Token method.
Note: If you don’t have the secureTokenId, use our List Secure Tokens method to search for the secure token.
When you delete a secure token, you can’t recover it, and you can’t reuse its identifier for a new token.
| Name | In | Type | Description |
|---|---|---|---|
processingTerminalIdRequired | path | string | Unique identifier that we assigned to the terminal. |
secureTokenIdRequired | path | string | Unique identifier that the merchant assigned to the secure token. |
Successful request. We deleted the secure token.
No response body — a 204 means the action took effect.
Invalid request
{
"detail": "One or more validation errors occurred, see error section for more info",
"errors": [
{
"detail": "invalid date",
"message": "Expected time, got '' for start_time",
"parameter": "start_time"
}
],
"status": 400,
"title": "Bad request",
"type": "https://docs.payroc.com/api/errors#bad-request"
}Identity could not be verified
{
"detail": "Your identity could not be verified",
"status": 401,
"title": "Not Authorized",
"type": "https://docs.payroc.com/api/errors#not-authorized"
}Do not have permissions to perform this action
{
"detail": "You do not have the required permissions to perform this action",
"instance": "https://api.payroc.com/v1/exampleResource/3",
"resource": "exampleResource",
"status": 403,
"title": "Forbidden",
"type": "https://docs.payroc.com/api/errors#forbidden"
}Resource not found
{
"detail": "Resource not found",
"resource": "(The Type of the Resource)",
"status": 404,
"title": "Not found",
"type": "https://docs.payroc.com/api/errors#not-found"
}An error has occured
{
"detail": "We are unable to process your request at this time",
"errors": [
{
"message": "Service offline"
}
],
"status": 500,
"title": "Api error",
"type": "https://docs.payroc.com/api/errors#api-error"
}