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

​
Overview

Adjusts the quantity of a specific card in the cart. Use positive numbers to add more, negative to reduce.

​
Request

​
Path Parameters

ParameterTypeRequiredDescription
cartIdstringYesCart UUID
cardIdstringYesCard UUID within the cart

​
Body Parameters

ParameterTypeRequiredDescription
qtyintegerYesQuantity adjustment (positive to add, negative to remove)
curl -X PUT https://sandbox-api.cardcash.com/v3/carts/CART_ID/cards/CARD_ID \
  -H "x-cc-app: YOUR_APP_ID" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "qty": 2 }'

​
Response

Returns the full updated cart object: 
{
  "cartId": "...",
  "cards": [...],
  "couponData": null
}
If partial fulfillment occurs (not enough inventory for the full quantity): 
{
  "cart": {
    "cartId": "...",
    "cards": [...]
  },
  "requested": 5,
  "added": 3
}

​
Error Response

{
  "message": ["Error, insufficient inventory"]
}

​
Notes

  • Positive qty adds cards; negative qty removes cards
  • If reducing quantity to zero, use Remove Card instead
  • Check added vs requested in the response for partial fulfillment