---
title: "Set Card Status"
method: POST
path: "/pws/v2/pws_set_card_status/"
tags: ["Card V2"]
---

# Set Card Status

`POST /pws/v2/pws_set_card_status/`

This web service sets the status for a token(card) and verifies the system and network status of a card. This can be used in changing the status of a card while card is still in use or alternatively when the card is renewed.version 2 supports idempotency.

## Request body

- SetCardModelV2
  - `api_call_unique_identifier` string, required — Unique number that must be passed at each API request. Identifier to make each API request unique
  - `client_id` integer, required — Unique identifier for the client which Paymentology will provide at outset
  - `status_nwk` string, required — <p>Status network :</p> <ul> <li class="docBullet">1000 : Fully operational DE39=00</li> <li class="docBullet">1001 : Refer to issuer DE39=01</li> <li class="docBullet">1004 : Capture card DE39=04</li> <li class="docBullet">1005 : Decline all txns DE39=05</li> <li class="docBullet">1006 : Inactive - pin blocked DE39=75</li> <li class="docBullet">1007 : Decline all txns (Visa: DE39=12) (MC: DE39=14)</li> <li class="docBullet">1008 : Honour with ID DE39=08</li> <li class="docBullet">1009 : Void card (Visa: DE39=46) (MC: DE39=62)</li> <li class="docBullet">1010 : Due Payment Block</li> <li class="docBullet">1011 : KYC/AML/compliance hold</li> <li class="docBullet">1041 : Lost card - capture DE39=41</li> <li class="docBullet">1043 : Stolen card - capture DE39=43</li> <li class="docBullet">1054 : Expired card - report DE39=54</li> <li class="docBullet">1154 : Expire card - don't inform</li> <li class="docBullet">1062 : Restricted card</li> <li class="docBullet">1199 : Void card - report DE39=05</li></ul>
  - `token` integer, required — Public token for the card
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request
  - `action` integer — <ul> <li class="docBullet">1 ==&gt; Normal card status change.</li> <li class="docBullet">2 ==&gt; card status change once any card is renewed.The incoming `status_nwk` is overridden by the `status_nwk` passed during renewal.</li> </ul> <p><br />If not provided then default action = 1.<br />If renewed card not found and we send action = 2 , then it will act as normal card status change</p>
  - `note` string — Short note of card status change
  - `update_digital_token` boolean — Update all linked digital token. Default value is false.

## Response `200`

Successful Response

- SetCardStatusResponseModel
  - `header` SetCardStatusResponseHeader
    - `error_id` integer — error id
    - `error_desc` string — error message
  - `body` SetCardStatusResponseBody
    - `status_nwk` integer — <p>Status network :</p> <ul> <li class="docBullet">1000 : Fully operational DE39=00</li> <li class="docBullet">1001 : Refer to issuer DE39=01</li> <li class="docBullet">1004 : Capture card DE39=04</li> <li class="docBullet">1005 : Decline all txns DE39=05</li> <li class="docBullet">1006 : Inactive - pin blocked DE39=75</li> <li class="docBullet">1008 : Honour with ID DE39=08</li> <li class="docBullet">1041 : Lost card - capture DE39=41</li> <li class="docBullet">1043 : Stolen card - capture DE39=43</li> <li class="docBullet">1054 : Expired card - report DE39=54</li> <li class="docBullet">1154 : Expire card - don't inform</li> <li class="docBullet">1062 : Restricted card</li> <li class="docBullet">1199 : Void card - report DE39=05</li></ul>

## Other responses

- `404` — Webservices does not exist
- `500` — Internal Server error

---

[API](https://skmtc.net/paymentology/apis/payapi-docs.md) · [All operations](https://skmtc.net/paymentology/apis/payapi-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymentology/payapi-docs/revisions/a675891b0365/schema)