Replace Reported Card
After review, the SaaS app can replace a reported card (e.g., lost/stolen). Replacement triggers a new issuance flow.
POST{baseUrl}/pcs/api/v1/replace-card
Payload
| Attribute | Type | Required | Description |
|---|---|---|---|
| cardId | Integer | Yes | Original card ID. |
| cardToken | Integer | No | Original card token (optional if cardId provided). |
| remarks | String | No | Reason/remarks for replacement. |
Request Example
{
"cardId": 5,
"cardToken": 369633943,
"remarks": "Card was stolen"
}Response
| Field | Type | Description |
|---|---|---|
| cardId | Integer | New replacement card ID. |
| cardToken | Integer | New replacement card token. |
| status | Enum | Will be ISSUANCE_IN_PROGRESS. |
| message | String | Action message. |
200 — SUCCESS
{
"data": {
"cardId": 1,
"cardToken": 771231868,
"status": "ISSUANCE_IN_PROGRESS",
"message": "Card replaced successfully!"
}
}