Development
  • Guides
  • API Reference
  • API Explorer
  • SDKs
  • Sample apps
  • System status
Support
  • Developer forums
  • Developer blog
  • YouTube
  • X
More
  • Square Home
  • Square Developer
  • App Marketplace
  • Partner with Square
  • Solutions Partner Program
  • Pricing
  • Sales

© 2026 Square, Inc.

  • Developer terms of service
  • Developer Integration and Marketing Agreement
  • Privacy policy
  • Partnerships
  • Sign In
  • Sign In

    Cards

  • List cards

  • Create card

  • Retrieve card

  • Disable card

  • Webhooks

  • card.automatically_updated

  • card.created

  • card.disabled

  • card.forgotten

  • card.updated

<- Cards webhooks

Cards webhooks

All versions ->

card automatically_updated

EVENT

 card.automatically_updated

Published when Square automatically updates the expiration date or primary account number (PAN) of a card or adds or removes an issuer alert.

Permissions:PAYMENTS_READ
Link to section

Event payload

Example code

Link to section

merchant_id

string

The ID of the target seller associated with the event.

Link to section

type

string

The type of this event. The value is "card.automatically_updated".

Link to section

event_id

string

A unique ID for the event.

Link to section

created_at

string

Read only The timestamp of when the event was created, in RFC 3339 format.

Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

Link to section

data

The data associated with the event.

Link to section

Examples

All versions ->

Response JSON

{ "merchant_id": "6SSW7HV8K2ST5", "type": "card.automatically_updated", "event_id": "d214f854-adb1-4f56-b078-4b8697a3187a", "created_at": "2020-02-15T04:38:13Z", "data": { "type": "card", "id": "ccof:uIbfJXhXETSP197M3GB", "object": { "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": true, "exp_month": 11, "exp_year": 2022, "last_4": "1111", "merchant_id": "6SSW7HV8K2ST5", "prepaid_type": "NOT_PREPAID", "reference_id": "user-id-2", "hsa_fsa": false, "version": 2 } } } }