PUT
/
v3
/
wallets
/
{cardId}
Update Wallet Card
curl --request PUT \
  --url https://sandbox-api.cardcash.com/v3/v3/wallets/{cardId} \
  --header 'Authorization: Bearer <token>'

​
Overview

Updates a wallet card’s status (active, archived) or current balance.

​
Request

​
Path Parameters

ParameterTypeRequiredDescription
cardIdintegerYesWallet card ID

​
Body Parameters

ParameterTypeRequiredDescription
statusstringNoNew status: "ACTIVE", "ARCHIVED", or "DELETED"
balancenumberNoUpdated current balance
curl -X PUT https://sandbox-api.cardcash.com/v3/wallets/789 \
  -H "x-cc-app: YOUR_APP_ID" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "status": "ARCHIVED" }'
Or to update balance: 
curl -X PUT https://sandbox-api.cardcash.com/v3/wallets/789 \
  -H "x-cc-app: YOUR_APP_ID" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "balance": 25.50 }'

​
Response

Returns the full wallet card detail (same as Get Wallet Card): 
{
  "id": 789,
  "merchant": { ... },
  "order": { ... },
  "amount": {
    "balance": 50.00,
    "cost": 45.75,
    "currentBalance": 25.50
  },
  "status": "active",
  ...
}

​
Status Values

StatusDescription
ACTIVECard is visible and usable
ARCHIVEDCard is hidden from default wallet view
DELETEDCard is permanently removed

​
Notes

  • Archiving a card hides it from the default wallet list; pass ?archived=true to GET /wallets to include it
  • Updating balance is useful for tracking partial card usage
  • Status updates are irreversible for DELETED