EVevervault
Payments
Real-time Account Updater

Check a card for account updates

Changed on

Provide an Evervault encrypted or plaintext card number and expiry, and Evervault synchronously queries the card networks for the latest card details.

The check is a stateless, synchronous request to the card networks: it doesn't enroll the card for ongoing updates. If the card is subscribed for asynchronous updates, you may also receive the update via a real-time.card.updated webhook afterwards. Only Visa and Mastercard cards are supported. A card of any other brand is rejected with a 400 status code.

The plaintext card number is never stored or returned. If a new card number is available, it's returned re-encrypted as an Evervault encrypted string.

post/payments/cards/checks

Request

Request body

Example request

{
  "card": {
    "number": "ev:debug:Tk9D:number:nTepvAI585M7lUVp:AkJ6Brzat0E7ui8DSKCSXO7AopU/+GFuBekQ6cGx7eTl:sfihK53itmHp+URxomnTITUpwQwM5nnRrnQ0qdIOUlA=:$",
    "expiry": {
      "month": "12",
      "year": "29"
    }
  }
}

Response

The check completed.

idstring required

The unique identifier for the check.

result'no-change' | 'new-expiry-date' | 'new-account-number' | 'account-closed' | 'contact-cardholder' | 'cardholder-opt-out' | 'merchant-opt-out' | 'no-match' required

The outcome of the check. Only new-expiry-date and new-account-number carry an update payload; every other result returns no new credentials.

Example response

{
  "id": "auc_8da9a7fbde01",
  "result": "new-account-number",
  "update": {
    "card": {
      "number": "ev:debug:Tk9D:number:nTepvAI585M7lUVp:AkJ6Brzat0E7ui8DSKCSXO7AopU/+GFuBekQ6cGx7eTl:sfihK53itmHp+URxomnTITUpwQwM5nnRrnQ0qdIOUlA=:$",
      "expiry": {
        "month": "12",
        "year": "29"
      }
    }
  }
}

Changes