LogoLogo
Document ValidationsPayment Methods
Latest
Latest
  • D24 APIs
  • Getting Started with D24
  • Using LLMs with D24
  • API Documentation
    • Deposits API
      • Technical and Security Aspects
        • Calculating the Signature
      • Endpoints
        • Deposit Creation Endpoint
          • Notifications
        • PCI Deposit Creation Endpoint
        • Deposit Status Endpoint
        • Payment Methods Endpoint
        • Currency Exchange Endpoint
        • Crypto Exchange Endpoint
        • Country States Codes Endpoint
        • Refund Creation Endpoint
          • Notifications
        • Refund Status Endpoint
      • Payment Methods
        • ๐ŸŒŽAmerica
          • ๐Ÿ‡ฆ๐Ÿ‡ทArgentina
          • ๐Ÿ‡ง๐Ÿ‡ดBolivia
          • ๐Ÿ‡ง๐Ÿ‡ทBrazil
          • ๐Ÿ‡จ๐Ÿ‡ฑChile
          • ๐Ÿ‡จ๐Ÿ‡ฆCanada
          • ๐Ÿ‡จ๐Ÿ‡ดColombia
          • ๐Ÿ‡ช๐Ÿ‡จEcuador
          • ๐Ÿ‡ฌ๐Ÿ‡นGuatemala
          • ๐Ÿ‡ฒ๐Ÿ‡ฝMexico
          • ๐Ÿ‡ต๐Ÿ‡พParaguay
          • ๐Ÿ‡ต๐Ÿ‡ชPeru
        • ๐ŸŒAfrica
          • ๐Ÿ‡ง๐Ÿ‡ฏBenin
          • ๐Ÿ‡ง๐Ÿ‡ผBotswana
          • ๐Ÿ‡จ๐Ÿ‡ฒCameroon
          • ๐Ÿ‡จ๐Ÿ‡ฌCongo Brazzaville
          • ๐Ÿ‡จ๐Ÿ‡ฉCongo DRC
          • ๐Ÿ‡ช๐Ÿ‡ฌEgypt
          • ๐Ÿ‡ฌ๐Ÿ‡ฆGabon
          • ๐Ÿ‡ฌ๐Ÿ‡ญGhana
          • ๐Ÿ‡จ๐Ÿ‡ฎIvory Coast
          • ๐Ÿ‡ฐ๐Ÿ‡ชKenya
          • ๐Ÿ‡ณ๐Ÿ‡ฌNigeria
          • ๐Ÿ‡ฒ๐Ÿ‡ผMalawi
          • ๐Ÿ‡ฒ๐Ÿ‡ฑMali
          • ๐Ÿ‡ท๐Ÿ‡ผRwanda
          • ๐Ÿ‡ฟ๐Ÿ‡ฆSouth Africa
          • ๐Ÿ‡น๐Ÿ‡ฌTogo
          • ๐Ÿ‡บ๐Ÿ‡ฌUganda
          • ๐Ÿ‡ฟ๐Ÿ‡ฒZambia
          • ๐Ÿ‡น๐Ÿ‡ฟTanzania
        • ๐ŸŒAsia
          • ๐Ÿ‡ง๐Ÿ‡ฉBangladesh
          • ๐Ÿ‡จ๐Ÿ‡ณChina
          • ๐Ÿ‡ญ๐Ÿ‡ฐHong Kong
          • ๐Ÿ‡ฎ๐Ÿ‡ณIndia
          • ๐Ÿ‡ฎ๐Ÿ‡ฉIndonesia
          • ๐Ÿ‡ฏ๐Ÿ‡ตJapan
          • ๐Ÿ‡ฒ๐Ÿ‡พMalaysia
          • ๐Ÿ‡ต๐Ÿ‡ฐPakistan
          • ๐Ÿ‡น๐Ÿ‡ญThailand
          • ๐Ÿ‡น๐Ÿ‡ทTurkey
          • ๐Ÿ‡ป๐Ÿ‡ณVietnam
      • API Codes
    • Cashouts API
      • Technical and Security Aspects
        • Calculating the Payload-Signature
      • Endpoints
        • Cashout Creation Endpoint
          • Notifications
        • Cashout Status Endpoint
        • Cashout Update Status Endpoint
        • Cashout Cancellation Endpoint
        • Cashout Bank Codes
      • Countries Validations
        • American Countries
          • ๐Ÿ‡ง๐Ÿ‡ดBolivia
          • ๐Ÿ‡ง๐Ÿ‡ทBrazil
          • ๐Ÿ‡จ๐Ÿ‡ฆCanada
          • ๐Ÿ‡จ๐Ÿ‡ฑChile
          • ๐Ÿ‡จ๐Ÿ‡ดColombia
          • ๐Ÿ‡ช๐Ÿ‡จEcuador
          • ๐Ÿ‡ฒ๐Ÿ‡ฝMexico
          • ๐Ÿ‡ต๐Ÿ‡ชPeru
          • ๐Ÿ‡ฆ๐Ÿ‡ทArgentina
          • ๐Ÿ‡ต๐Ÿ‡พParaguay
        • African Countries
          • ๐Ÿ‡ง๐Ÿ‡ผBotwsana
          • ๐Ÿ‡จ๐Ÿ‡ฒCameroon
          • ๐Ÿ‡จ๐Ÿ‡ฌCongo Brazzaville
          • ๐Ÿ‡จ๐Ÿ‡ฉCongo DRC
          • ๐Ÿ‡ช๐Ÿ‡ฌEgypt
          • ๐Ÿ‡ฌ๐Ÿ‡ฆGabon
          • ๐Ÿ‡ฌ๐Ÿ‡ญGhana
          • ๐Ÿ‡ฐ๐Ÿ‡ชKenya
          • ๐Ÿ‡ฒ๐Ÿ‡ผMalawi
          • ๐Ÿ‡ณ๐Ÿ‡ฌNigeria
          • ๐Ÿ‡ท๐Ÿ‡ผRwanda
          • ๐Ÿ‡ฟ๐Ÿ‡ฆSOUTH AFRICA
          • ๐Ÿ‡ฟ๐Ÿ‡ฒZambia
          • ๐Ÿ‡จ๐Ÿ‡ฎIvory coast
        • Asian Countries
          • ๐Ÿ‡ง๐Ÿ‡ฉBangladesh
          • ๐Ÿ‡จ๐Ÿ‡ณChina
          • ๐Ÿ‡ฎ๐Ÿ‡ณIndia
          • ๐Ÿ‡ฎ๐Ÿ‡ฉIndonesia
          • ๐Ÿ‡ฏ๐Ÿ‡ตJapan
          • ๐Ÿ‡ฒ๐Ÿ‡พMalaysia
          • ๐Ÿ‡น๐Ÿ‡ญThailand
          • ๐Ÿ‡น๐Ÿ‡ทTurkey
          • ๐Ÿ‡ต๐Ÿ‡ฐPakistan
          • ๐Ÿ‡ป๐Ÿ‡ณVietnam
        • Oceania Countries
          • ๐Ÿ‡ฆ๐Ÿ‡บAustralia
      • API Codes
    • Subscriptions API
      • Technical and Security Aspects
        • Calculating the Signature
      • Subscription Creation Endpoints
        • OneShot Subscription Creation
        • PCI Subscription Creation Endpoint
        • Notifications
      • Subscription Cancellation Endpoint
      • Subscription Status Endpoint
    • Card-On-File API
      • Technical and Security Aspects
        • Calculating the Signature
      • Create Card Token Endpoint
      • Retrieve Card Token Endpoint
      • Delete Card Token Endpoint
    • Bank Accounts Validation API
      • Technical and Security Aspects
        • Calculating the Signature
      • Endpoints
        • Bank Account Validation Endpoint
        • Pix Key Validation Endpoint
      • API Codes
    • KYC API
      • Technical and Security Aspects
        • Calculating the Signature
      • KYC Endpoint
      • API Codes
    • Reconciliation API
      • Technical and Security Aspects
      • Endpoints
      • API Codes
    • Quickpay
      • Endpoints
        • Deposit creation endpoint
          • Notifications
        • Deposit Status Endpoint
    • Tools for Platforms
      • Technical and Security Aspects
        • Calculating the Signature
      • SubMerchant Creation
        • Notifications
      • SubMerchant Status Endpoint
      • Commission Update Endpoint
  • PLUGINS
    • Shopify
      • Installation
      • Onboarding
      • Customer flow
      • Admin Flow
      • Tutorials
      • FAQ
    • WooCommerce
      • Installation
      • Configuration
  • Deposits Tools
    • Cards SDK
      • With User Interface
        • ๐Ÿš€Color Customization
      • Without User Interface
    • Java SDK
    • PHP SDK
  • Knowledge Base
    • Countries Specifications
    • Subscriptions with Card On File
    • Deposits with Cards SDK
      • With User Interface
      • Without User Interface
    • Deposits with 3DS Authentication
    • Deposits with Installments
  • v1 Developers Guide
  • Status Page
Powered by GitBook
On this page

Was this helpful?

  1. API Documentation
  2. Card-On-File API

Delete Card Token Endpoint

Invalidates a previously generated card identifier, preventing its future use for transactions.

PreviousRetrieve Card Token EndpointNextBank Accounts Validation API

Last updated 24 days ago

Was this helpful?


Request

Path Parameters

Parameter
Type
Required
Description

card_identifier

String

Yes

The unique card identifier to invalidate


Response

Success Response (204 OK)

The endpoint will return a 204 code, with no content, in case of successfully deleting the requested card_identifier


Error Responses

HTTP Status
Error Code
Description

404

510

Token not found

401

511

Token expired

401

512

Unauthorized access

Error Response Example

{
    "code": 510,
    "description": "Token not found"
}

Integration Example

cURL Example

curl -X DELETE https://cc-api-stg.directa24.com/v3/tokenization/CID-2210908e-6d8e-468d-9eb3-d551e8b541a0 \
  -H "Content-Type: application/json" \
  -H "X-Date: $(date -u +"%Y-%m-%dT%H:%M:%SZ")" \
  -H "X-Login: YOUR_X_LOGIN_API_KEY" \
  -H "Authorization: YOUR_AUTHORIZATION_HASH" \
  -i

Common Use Cases

  1. Subscription cancellation: Invalidate the identifier when a customer cancels their subscription

  2. Card replacement: Invalidate old identifiers when a customer updates their payment method

  3. Fraud prevention: Invalidate identifiers associated with suspected fraudulent activity

  4. Account closure: Remove all payment information when a customer closes their account

  5. Compliance: Adhere to data retention policies by removing unnecessary payment data


Notes

  • Once an identifier is invalidated, it cannot be reactivated

  • Any attempt to use an invalidated identifier for transactions will result in an error

  • Only identifiers that belong to your merchant account can be invalidated

  • We recommend keeping track of invalidated identifiers in your system to avoid future usage attempts

Invalidate a Card Token

delete

Invalidates a previously generated card token, preventing its future use for transactions

Authorizations
Path parameters
card_identifierstringRequired

The unique card token to invalidate

Example: CID-2210908e-6d8e-468d-9eb3-d551e8b541a0
Header parameters
Content-TypestringRequired

Media type of the body sent to the API

Default: application/json
X-Datestring ยท date-timeRequired

ISO8601 Datetime with Timezone (yyyy-MM-dd'T'HH:mm:ssZ)

X-LoginstringRequired

Merchant X-Login API Key

X-Idempotency-KeystringOptional

Unique idempotency key for ensuring that the same request is not processed more than once

Responses
204
Card token successfully invalidated
401
Authentication error
application/json
404
Token not found
application/json
delete
DELETE /v3/tokenization/{card_identifier} HTTP/1.1
Host: cc-api-stg.directa24.com
Authorization: YOUR_API_KEY
Content-Type: application/json
X-Date: 2025-06-06T05:50:03.354Z
X-Login: text
Accept: */*

No content

  • DELETEInvalidate a Card Token
  • Request
  • Path Parameters
  • Response
  • Success Response (204 OK)
  • Error Responses
  • Error Response Example
  • Integration Example
  • cURL Example
  • Common Use Cases
  • Notes