Sign in
Cards servicing

Activate a card

Activates the card with the ID specified in the request URL. Please note the following preconditions:<br> <ul> <li>The card must have a status value of ACTIVE or INACTIVE (if activating a replacement card).</li> <li>The account to which the card is tied must have a blocking_status value of NO_BLOCK.</li> </ul> You can also include in the request the pan_last_4_digit and expiry_date. These are optional parameters you can collect from the cardholder upon receipt of their card in the mail, to ensure they are activating the right card. <br><br> You can then verify both parameters against the card details you have on file for the customer, before sending the activation request to Solaris. Solaris will then perform a validation of both parameters before accepting the request. <br><br><br> Note: Card activation requests are blocked for the first 24 hours after card creation. In order to test on Sandbox with immediate activation, please include the string WITHSTATICTOKEN within the line_1 property when creating a card.

post/v1/cards/{card_account_id}/activate

Path parameters

card_account_idstring required

Request body

pan_last_4_digitstring

The last 4 digits of the card's PAN.

expiry_datestring

The card expiry date. Format should be mm/yy.

Example request

{
  "pan_last_4_digit": "2314",
  "expiry_date": "01/23"
}

Response

Successful result of the operation

expiration_datestring

The expiration date of the card.

new_card_orderedboolean

Boolean that indicates if a new physical card was ordered for this card resource (either for the first time or as a replacement).

person_idstring

ID of the cardholder person resource.

account_idstring

ID of the account to which the card is tied.

business_idstring

(For business cards) ID of the business with which the card is associated.

sia_account_numberstring

SIA account number

creation_datestring

Date when the latest plastic card for this card resource was created.

idstring

ID of the card.

status'ACTIVE' | 'ACTIVATION_BLOCKED_BY_SOLARIS' | 'BLOCKED' | 'BLOCKED_BY_SOLARIS' | 'CLOSED' | 'CLOSED_BY_SOLARIS' | 'COUNTERFEIT_CARD' | 'FRAUD' | 'INACTIVE' | 'LOST' | 'NEVER_RECEIVED' | 'PROCESSING' | 'STOLEN'

The current status of the card.

referencestring

Unique reference number for the card.

type'MASTERCARD_DEBIT' | 'MASTERCARD_BUSINESS_DEBIT' | 'VIRTUAL_MASTERCARD_DEBIT' | 'VIRTUAL_MASTERCARD_BUSINESS_DEBIT' | 'VIRTUAL_MASTERCARD_FREELANCE_DEBIT' | 'VISA_DEBIT' | 'VISA_BUSINESS_DEBIT' | 'VIRTUAL_VISA_DEBIT' | 'VIRTUAL_VISA_BUSINESS_DEBIT' | 'VIRTUAL_VISA_FREELANCE_DEBIT' | 'VISA_CREDIT' | 'VIRTUAL_VISA_CREDIT' | 'VISA_BUSINESS_CREDIT' | 'VIRTUAL_VISA_BUSINESS_CREDIT'

The type of the card. Note The following enum list is not exhaustive but only indicative of some possible values.

Example response

[
  {
    "expiration_date": "2020-12-30",
    "person_id": "6dceb838ea04090aaa4277c7ea8a1c78cper",
    "account_id": "6cbac416a5d91aaf5e6bc9ee15d58799cacc",
    "business_id": "52e6a9b8a559d842ed7d8901b0e1bf4bcbiz",
    "sia_account_number": "500000001103",
    "creation_date": "2022-05-01",
    "id": "2b890724292e287935420a2ca13ae7f9mcrd",
    "reference": "b92b6840d6345b11f29b598c10bae770",
    "representation": {
      "line_1": "SLY STALLONE",
      "line_2": "TEST COMPANY GMBH",
      "masked_pan": "537458******4567",
      "formatted_expiration_date": "09/22"
    }
  }
]