> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# vault.payment_permission.updated

> A user's permission for your app to pay with one of their cards changed: granted, turned off, or ended because they removed the card.

A user's permission for your app to pay with one of their cards changed. `status` says where it stands now: `active` means your app can pay with `card_id` without asking, `revoked` means the user turned it off or your app's connection to the user ended, and `retired` means the user removed the card. See [Enable auto-approval](/vault/app-auto-approval).

`grant_id` names the permission on one card, and it stays the same when the user turns the permission back on. `allowance_id` is the same for every card the user gives your app. Each change carries the next `revision` for its `grant_id`. A delivery can repeat or arrive late, so keep the highest `revision` you have for each `grant_id` and ignore any event with a lower or equal one.

```json theme={null}
{
  "id": "evt_4a91c2e07b5d3f86e1a2c9b0",
  "type": "vault.payment_permission.updated",
  "created": 1759430467,
  "livemode": true,
  "data": {
    "user_id": "usr_8f3k2m",
    "card_id": "vc_7f3a9c2e1b4d6f8a0c2e4b6d",
    "client_id": "b1e0c6d2-5a7f-4c3e-9d8b-2f6a1e4c7b90",
    "grant_id": "apg_3585dcb59976ad25751aa7752ddbf257dfb1c3770e3cf3aaed845786ffbfa827",
    "allowance_id": "allowance_0b40a52f809fc78933413e03034129fd0392dbfef461a635016a98987aaf2632",
    "status": "active",
    "revision": 1
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.