Skip to main content

CardUpdateRequest

The fields submitted in this object will update the existing values for the corresponding card.

Since the update that will be performed is partial, only the submitted fields will be reflected.

statusCardStatus (string)

Contains information about the different card statuses.

  • ACTIVE - Card can be used for payments.
  • PENDING - Intermediate status before issuing a card, while performing additional validations.
  • CANCELLED - The card is canceled and can't be used for any kind of operation. The status is (IRREVERSIBLE).
  • SUSPENDED - The status is changed from CS (Customer Service) representative or due to customer actions like (wrong activation info).
  • APPLIED - Intermediate status for a card that is stuck due to technical reasons.
  • DIGITAL - PHYSICAL card that is active and can be used for online payments only, but it is not yet delivered to the client, and it is not activated.
  • REJECTED - Card is rejected due to technical / validation reasons.
  • LOCKED - Card is locked by the customer and can't be used for payments.
  • EXPIRED - Card is expired.
  • ISSUED - The status indicates that the customer has successfully applied for a PHYSICAL card, but the card is not yet activated and can't be used for payments.

Possible values: [ACTIVE, PENDING, CANCELLED, SUSPENDED, APPLIED, DIGITAL, REJECTED, LOCKED, EXPIRED, ISSUED]

statusReasonstring

The reason for card status change.

Possible values: <= 200 characters

Example: Card status changed from LOCKED to ACTIVE
pinstring

The Card pin should be 4 digits.

Possible values: >= 4 characters and <= 4 characters

Example: 3422
userAgentstringrequired

The User Agent used for the request. The field should follow the official specification - https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent#syntax

Possible values: <= 1000 characters

Example: Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0) Gecko/20100101 Firefox/42.0
CardUpdateRequest
{
  "status": "ACTIVE",
  "statusReason": "Card status changed from LOCKED to ACTIVE",
  "pin": "3422",
  "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0) Gecko/20100101 Firefox/42.0"
}