Update card

PUT /accounts/{account_id}/cards

Path parameters

Body

Update a card for an existing customer on an account

  • spend_limit integer | null

    Spending limit of card (in cents). If not provided, spending is still subject to the spend limit set at the issuer processor account (if any).

    Minimum value is 1.

  • lithic object
    • memo string

      Friendly name to identify the card

    • state string

      The new state of the card. CLOSED cannot be undone.

      Values are OPEN, PAUSED, or CLOSED.

Responses

  • • 200 object

    An account card.

    • spend_limit integer | null

      Spending limit of card (in cents). If not provided, spending is still subject to the spend limit set at the issuer processor account (if any).

      Minimum value is 1.

    • lithic object
      • token string(uuid)

        Unique external identifier for the card

      • card_program_token string(uuid)

        Token belonging to the card program under which to create the card.

      • last_four string

        Last four digits of the card

      • type string

        The type of card being returned

        Values are UNLOCKED, MERCHANT_LOCKED, or SINGLE_USE.

      • state string

        The current state of the card

        Values are OPEN, PAUSED, or CLOSED.

      • memo string

        Friendly name to identify the card

  • • 401

    Unauthorized.

  • • 403

    Forbidden.

  • • 422

    Invalid input

  • • 429

    Too many requests.

  • • default

    Unexpected Error.

PUT /accounts/{account_id}/cards 
curl \
 -X PUT https://<your_environment_name>-uat-api.canopyservicing.com/accounts/can_52322/cards \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"spend_limit":8000000,"lithic":{"memo":"Primary Business Card","state":"OPEN"}}'
Request example 
{
  "spend_limit": 8000000,
  "lithic": {
    "memo": "Primary Business Card",
    "state": "OPEN"
  }
}
Response example (200) 
{
  "spend_limit": 8000000,
  "lithic": {
    "token": "adccd28d-532e-480b-a063-a46a77a15570",
    "card_program_token": "a5e38341-cc95-4a9b-a21c-751aeca67e9c",
    "last_four": "0339",
    "type": "UNLOCKED",
    "state": "OPEN",
    "memo": "Conference Event Card"
  }
}