🚀 VaultsPay API v1 is live. See what's new →
Payment CardsDecline Reported Card

Decline Reported Card

After review, the SaaS app can decline a reported card (e.g., damaged/expired/stolen/lost).

POST{baseUrl}/pcs/api/v1/decline-card

Payload

AttributeTypeRequiredDescription
cardIdIntegerYesOriginal card ID.
cardTokenIntegerNoOriginal card token (optional if cardId provided).
remarksStringNoReason/remarks for decline.
Request Example
{
  "cardId": 5,
  "cardToken": 369633943,
  "remarks": "Decline reason"
}

Response

FieldTypeDescription
cardIdIntegerDeclined card ID.
cardTokenIntegerDeclined card token.
cardStatusEnumWill be FREEZE.
statusReasonStringStatus reason from the report card API call.
remarksStringAction remarks.
200 — SUCCESS
{
  "data": {
    "cardId": 22,
    "cardToken": 237719628,
    "cardStatus": "FREEZE",
    "statusReason": "My card is lost.",
    "remarks": "remarks for decline"
  }
}