---
title: "Replace a card"
method: POST
path: "/v1/cards/{card_account_id}/replace"
tags: ["Cards servicing"]
---

# Replace a card

`POST /v1/cards/{card_account_id}/replace`

Issues a replacement for the card specified in the request URL. Specify the appropriate `reason` in your request to trigger the right replacement process: <ul>  <li>**Reissue** a card expiring soon: `EXPIRES_SOON`</li>  <li>**Replace** a damaged card (physical card only): `DEFECTIVE_CARD`, `CARDHOLDER_REQUEST` (Deprecated) </li>  <li>Report a card as **lost or stolen** and request a replacement (physical cards only): `LOST`, `STOLEN`, `COUNTERFEIT_PLASTIC`, `PREVENTIVE_BLOCK`, `ONLINE_TRANSACTION_FRAUD`</li> </ul>  Please note the following: <br> For the **reissue** or **replace** flows: <ul>  <li>The new card will have the same card number, but it will have a new CVV and expiry date.</li> <li>Once you make this request, the card's status will change to `PROCESSING`, then `ACTIVE` or `BLOCKED` depending on the card's status prior to ordering. The value of the `new_card_ordered` property on the card resource will change to `true`.</li> <li>The customer can still use the old card until they activate the new one. Once they do so, the old one will no longer be authorized and the value of `new_card_ordered` will change to `false`.</li> </ul> For the **lost/stolen** flow: <ul>  <li>The new card will have a different card number.</li> <li>The old card will stop working immediately upon acceptance of the API request. This action cannot be undone.</li> </ul> Accepted card statuses: <ul> <li>**Reissue**: `ACTIVE`, `INACTIVE`</li> <li>**Replace** and **Lost/Stolen**: `ACTIVE`, `INACTIVE`, `BLOCKED`, `BLOCKED_BY_SOLARIS`</li> </ul> Please note that on **Sandbox** a given card can only be replaced once.

## Path parameters

- `card_account_id` string, required

## Request body

- ReplaceCardRequest — The content of the replace card request
  - `line_1` string — The name to print on the new card. For Replace flow only.
  - `line_2` string — Additional optional embossing line. For Replace flow only.
  - `reason` 'CARDHOLDER_REQUEST' | 'COUNTERFEIT_PLASTIC' | 'DEFECTIVE_CARD' | 'EXPIRES_SOON' | 'LOST' | 'ONLINE_TRANSACTION_FRAUD' | 'PREVENTIVE_BLOCK' | 'STOLEN' | 'SUSPECTED_MERCHANT_FRAUD' — The reason why the customer is requesting a replacement card.
  - `reference` string — Randomly generated UUID that acts as an idempotency key.
  - `retain_pin` boolean — Indicates whether or not the new card should use the same PIN as the old one. For Replace and Reissue flows, default is true. For Lost/Stolen, default is false.
  - `reported_at` string, date-time — For Lost/Stolen flow only. Timestamp from when the card was reported (ISO 8601 format).

## Response `200`

Successful result of the operation

- SolarisDecoratorsCardReplacementResponse
  - `id` string — 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.

## Other responses

- `400` — Invalid request.
- `403` — You are not authorized to perform this action.
- `404` — The resource could not be found.
- `500` — Internal server error.
- `default` — Unexpected error

---

[API](https://skmtc.net/solarisgroup/apis/card-creation-servicing.md) · [All operations](https://skmtc.net/solarisgroup/apis/card-creation-servicing/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/card-creation-servicing/revisions/a772504dcc9e/schema)