Disable card
POST
/v2/cards/{card_id}/disable
Disables the card, preventing any further updates or charges.
Disabling an already disabled card is allowed but has no effect.
Permissions
PAYMENTS_WRITE
Try in API Explorer
| Name | Description |
|---|---|
card_
Required
|
Unique ID for the desired Card. |
| Name | Description |
|---|
Response Fields
| Name | Description |
|---|---|
errors
|
Information on errors encountered during the request. |
card
|
The retrieved card. |
Examples
POST
/v2/cards/{card_id}/disable
cURL
- cURL
- Ruby
- Python
- C#
- Java
- PHP
- Node.js
curl https://connect.squareup.com/v2/cards/ccof%3AuIbfJXhXETSP197M3GB/disable \
-X POST \
-H 'Square-Version: 2021-07-21' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{}'
Response JSON
{
"card": {
"id": "ccof:uIbfJXhXETSP197M3GB",
"billing_address": {
"address_line_1": "500 Electric Ave",
"address_line_2": "Suite 600",
"locality": "New York",
"administrative_district_level_1": "NY",
"postal_code": "10003",
"country": "US"
},
"fingerprint": "ex-p-cs80EK9Flz7LsCMv-szbptQ_ssAGrhemzSTsPFgt9nzyE6t7okiLIQc-qw_quqKX4Q",
"bin": "411111",
"card_brand": "VISA",
"card_type": "CREDIT",
"cardholder_name": "Amelia Earhart",
"customer_id": "VDKXEEKPJN48QDG3BGGFAK05P8",
"enabled": false,
"exp_month": 11,
"exp_year": 2022,
"last_4": "1111",
"prepaid_type": "NOT_PREPAID",
"reference_id": "user-id-1",
"version": 2
}
}