Skip to main content
POST
/
webhooks
/
vgs
/
account-updater
VGS Account Updater webhook
curl --request POST \
  --url http://localhost:3156/webhooks/vgs/account-updater \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "evt_test_123456789",
  "event": "cmp_au_card.updated",
  "timestamp": "2025-01-15T10:00:00.000Z",
  "details": {
    "card_id": "card_test_123456789",
    "card_last4": "1234",
    "card_first8": "41111111",
    "card_bin": "411111",
    "card_fingerprint": "fp_test_123456789",
    "fingerprint_matches": "true",
    "new_account_number": "tok_test_new_123456789",
    "new_expiration_date": "1225",
    "occurred_at": "2025-01-15T10:00:00.000Z",
    "old_account_number": "tok_test_old_123456789",
    "old_expiration_date": "1224",
    "reason_code": "CARD_EXPIRED",
    "reason_text": "Card has expired and been replaced"
  },
  "description": "Card updated with new expiration date",
  "fingerprint": "fp_test_123456789",
  "grouping": "grp_test_123456789",
  "integration_id": "int_test_123456789",
  "occurrence": 1,
  "org_id": "org_test_123456789",
  "producer": {
    "application_name": "account-updater",
    "application_protocol": "https"
  },
  "scope": "card",
  "summary": "Card updated successfully",
  "tenant": "tnt_test_123456789"
}
'
{
  "status": "ok"
}

Body

application/json
​
id
string
required

Unique event identifier

Example:

"evt_test_123456789"

​
event
enum<string>
required

VGS Account Updater event types

Available options:
cmp_au_card.updated,
cmp_au_card.expired,
cmp_au_card.closed,
cmp_au_card.non_participating,
cmp_au_card.contact_cardholder_advice,
cmp_au_card.unknown,
cmp_au_card.enrolled,
cmp_au_card.opt_out,
cmp_au_card.enrollment.failed
​
timestamp
string<date-time>
required

When the webhook was sent

Example:

"2025-01-15T10:00:00.000Z"

​
details
object
required
​
description
string

Event description

Example:

"Card updated with new expiration date"

​
fingerprint
string

Event fingerprint for deduplication

Example:

"fp_test_123456789"

​
grouping
string

Event grouping identifier

Example:

"grp_test_123456789"

​
integration_id
string

VGS integration identifier

Example:

"int_test_123456789"

​
occurrence
number

Event occurrence number

Example:

1

​
org_id
string

VGS organization identifier

Example:

"org_test_123456789"

​
producer
object
​
scope
string

Event scope

Example:

"card"

​
summary
string

Event summary

Example:

"Card updated successfully"

​
tenant
string

VGS tenant identifier

Example:

"tnt_test_123456789"

Response

Webhook processed successfully

​
status
enum<string>
required

Response status

Available options:
ok
Example:

"ok"