Update a card

Update a linked card and/or resubmit it for verification. If a value is provided for CVV, a new verification ($0 authorization) will be submitted for the card. Updating the expiration date or address will update the information stored on file for the card but will not be verified. Only use this endpoint if you have provided Moov with a copy of your PCI attestation of compliance.

To use this endpoint from the browser, you’ll need to specify the /accounts/{accountID}/cards.write scope when generating a token.

PATCH

/accounts/{accountID}/cards/{cardID}

cURL

1
2
3
4
5
6
7
8


curl --request PATCH "https://api.moov.io/accounts/{accountID}/cards/{cardID}" \
  -H "Authorization: Bearer {token}" \
  --data-raw '{
    "expiration": {
      "month":"01",
      "year":"28"
    }
  }'\

200 404 409 422 429

Card updated.

Describes a card on a Moov account.

{
  "billingAddress": {
    "addressLine1": "123 Main Street",
    "addressLine2": "Apt 302",
    "city": "Boulder",
    "country": "US",
    "postalCode": "80301",
    "stateOrProvince": "CO"
  },
  "bin": "123456",
  "brand": "Discover",
  "cardAccountUpdater": {
    "updateType": "number-update",
    "updatedOn": "2019-08-24T14:15:22Z"
  },
  "cardID": "ec7e1848-dc80-4ab0-8827-dd7fc0737b43",
  "cardOnFile": true,
  "cardType": "debit",
  "cardVerification": {
    "accountName": {
      "firstName": "match",
      "fullName": "match",
      "lastName": "match",
      "middleName": "match"
    },
    "addressLine1": "match",
    "cvv": "match",
    "postalCode": "match"
  },
  "domesticPullFromCard": "supported",
  "domesticPushToCard": "fast-funds",
  "expiration": {
    "month": "01",
    "year": "21"
  },
  "fingerprint": "9948962d92a1ce40c9f918cd9ece3a22bde62fb325a2f1fe2e833969de672ba3",
  "holderName": "Jules Jackson",
  "issuer": "GRINGOTTS BANK",
  "issuerCountry": "US",
  "lastFourCardNumber": "1234",
  "merchantAccountID": "50469144-f859-46dc-bdbd-9587c2fa7b42",
  "paymentMethods": [
    {
      "paymentMethodID": "9506dbf6-4208-44c3-ad8a-e4431660e1f2",
      "paymentMethodType": "card-payment"
    },
    {
      "paymentMethodID": "3f9969cf-a1f3-4d83-8ddc-229a506651cf",
      "paymentMethodType": "push-to-card"
    }
  ]
}

No card with the specified accountID was found.

Attempting to update an existing disabled card.

The supplied card data appeared invalid or was declined by the issuer.

{
  "error": "card re-verification failure: do-not-honor"
}

Request was refused due to rate limiting.

X-Retry-In


      string
      <duration>

How long (in milliseconds) to wait until able to retry the request.

Path parameters

accountID


      string
      <uuid>

required

ID of the Moov account representing the cardholder.

cardID


      string
      <uuid>

required

ID of the card.

Body

application/json

Describes properties of a card to update.

billingAddress


        object

Provide address fields as necessary to patch the currently saved address. Omit any fields that should not be changed.

Show child attributes

addressLine1


        string

<=60 characters

addressLine2


        string

<=32 characters

city


        string

<=24 characters

country


        string

<=2 characters

postalCode


        string

<=5 characters

stateOrProvince


        string

<=2 characters

cardCvv


        string

Provide a CVV to trigger a re-verification of this card. Omit CVV to update LinkedCard fields without re-verification.

cardOnFile


        boolean

Indicates cardholder has authorized card to be stored for future payments.

expiration


        object

Provide expiration date fields as necessary to patch the currently saved date. Omit any fields that should not be changed.

Show child attributes

month


        string

2 characters

year


        string

2 characters

Response

application/json

Describes a card on a Moov account.

billingAddress


        object

Show child attributes

addressLine1


        string

<=60 characters required

city


        string

<=24 characters required

country


        string

<=2 characters required

postalCode


        string

<=5 characters required

stateOrProvince


        string

<=2 characters required

addressLine2


        string

<=32 characters

bin


        string

brand


              string

The card brand.

Possible values: American Express, Discover, Mastercard, Visa

cardAccountUpdater


        object

The results of the most recent card update request.

Show child attributes

updateType


        string<enum>

The results of the card update request.

Possible values: unspecified, account-closed, contact-cardholder, expiration-update, no-change, no-match, number-update

updatedOn


        string<date-time>

<=24 characters

cardID


        string<uuid>

<=36 characters

UUID v4

cardOnFile


        boolean

Indicates cardholder has authorized card to be stored for future payments.

cardType


        string<enum>

The type of the card.

Possible values: debit, credit, prepaid, unknown

cardVerification


              object

The results of submitting cardholder data to a card network for verification.

Show child attributes

accountName


              object

The results of submitting cardholder name to a card network for verification.

Show child attributes