/ Guides / Cards / Manage digital wallet tokens / Update digital wallet tokens

Update digital wallet tokens

Transition a digital wallet token from one state to another.

Update a digital wallet token's state

Post/v2/cards/{cardId}/digital-wallet-token-transitions

Request

Use this endpoint to transition update a digital wallet token's state.

info

You can't update a digital wallet token that has the REQUEST_DECLINED or TERMINATED state, as these are final states. Instead, you should create a new digital wallet token for that card.

Sample requestRequest structure
Copy
Copied
curl -i -X POST \
  'https://api.equalsmoney.com/v2/cards/2471fbf0-cb07-42fc-863e-5979d5773122/digital-wallet-token-transitions?accountId=F12345' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "state": "ACTIVE",
    "digitalWalletToken": "9d3dee7c-19df-4b71-bbb9-521bb04307bf"
  }'
Copy
Copied
curl -i -X POST \
  'https://api.equalsmoney.com/v2/cards/{cardId}/digital-wallet-token-transitions?accountId={accountId}' \
  -H 'Authorization: ApiKey YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "state": "string",
    "digitalWalletToken": "string"
  }'

Path parameters

Parameter Description
cardId
string (uuid)
required		 The ID of the card to work with.

Allowable values:
An existing cardId (<= 36 characters)

Query parameters

Parameter Description
accountId
string
required		 The ID of the account that the card is associated with.

Allowable values:
An existing accountId
personId
string (uuid)		 The ID of the person that the card belongs to.

Allowable values:
An existing personId (<= 36 characters)

Request body schema

Parameter Description
state
string (enum)
required		 The state that you want to update the digital wallet token to. The original state is REQUESTED. You can't update the state if its current value is either REQUEST_DECLINED or TERMINATED.

Allowable values:
ACTIVE, SUSPENDED, TERMINATED
digitalWalletToken
string (uuid)
required		 The digital wallet token that you want to update the state for.

Allowable values:
An existing digitalWalletToken (<= 36)

Response

If your request is successful, you'll receive a 201 response. If you've subscribed to webhooks, you'll also receive a DigitalWalletTokenTransition webhook.

Sample responseResponse structure
Copy
Copied
{
  "fulfillmentStatus": "PROVISIONED",
  "digitalWalletToken": "b98cb680-2fd4-4c14-aa56-8d05091209d5",
  "state": "ACTIVE"
}
Copy
Copied
{
  "fulfillmentStatus": "string",
  "digitalWalletToken": "string",
  "state": "string"
}

For more detailed information about this request and its response, see the API reference.