Process Card Request

After card creation, the customer must set the PIN (physical cards). When PIN is set, the SaaS app calls this endpoint to move the card into processing.

POST{baseUrl}/pcs/api/v1/process-card-request

Payload

Attribute	Type	Required	Description
cardId	Integer	Yes	Card ID to process.
remarks	String	No	Processing remarks.
statusReason	String	No	Reason for status.
status	Enum	Yes	Must be `ISSUANCE_IN_PROGRESS`.

Request Example

{
  "cardId": 12,
  "remarks": "request accepted",
  "statusReason": "new card",
  "status": "ISSUANCE_IN_PROGRESS"
}

Response

Field	Type	Description
id	Integer	Card ID.
userId	Integer	Owner user ID.
userProfile	Object	Cardholder profile.
account	Object	Linked account details.
_3dsecure	Object	3DS details (if available).
cardTier	Object	Card tier details.
manufacturing	Object	Manufacturing stage entity.
delivery	Object	Delivery stage entity.
paymentCardType	Enum	e.g., DEBIT.
cardNetwork	Enum	e.g., MASTERCARD.
cardType	Enum	PHYSICAL or VIRTUAL.
billingCurrency	String	Billing currency (if present).
embossName	String	Cardholder name.
lastFourDigit	String	Last 4 digits (if available).
token	String/Number	Card token (if available).
tokenFlags	String	Token flags bitmask.
pinSet	Boolean	Whether PIN is set.
status	Enum	Should be `ISSUANCE_IN_PROGRESS`.
cardText	String	Status/action text.
cardCategory	Enum	e.g., STANDARD.
consumerType	Enum	e.g., CONSUMER.
reportedCards	Array	Any related reported-card records.
maxPurchaseLimit	Number	Max purchase limit.
statusReason	String	Reason for current status.
apiCallUniqueIdentifier	String	API-call unique trace ID.
cardTokens	Array	Linked tokens (if any).
processedAtThirdParty	Boolean	Whether processed at third party.
createdAt / updatedAt	String	Timestamps (ISO 8601).

200 — SUCCESS

{
  "data": {
    "id": 533,
    "userId": 5,
    "userProfile": {
      "id": 571,
      "pronounTitle": "Mr",
      "firstName": "John",
      "lastName": "Mock-Doe",
      "email": "default.user@vaultspay.ae",
      "countryCode": "971",
      "phone": "34343435",
      "language": "ENGLISH"
    },
    "account": {
      "id": 726,
      "accountId": 10,
      "userId": 5,
      "accountType": "DIGITAL",
      "currencyCode": "AED",
      "accountTitle": "DEFAULT USER DIGITAL AED",
      "accountNumber": "1000648060000040",
      "iban": "AE680961000648060000040"
    },
    "cardTier": { "id": 1, "enableFraudRules": false, "enableLimits": true },
    "manufacturing": { "id": 290, "configId": 2, "status": "PENDING" },
    "delivery": {
      "id": 290,
      "configId": 3,
      "status": "PENDING",
      "address": {
        "id": 381,
        "country": "Pakistan",
        "state": "Islamabad Capital Territory",
        "city": "Islamabad",
        "addressLine1": "Test address",
        "addressLine2": "",
        "type": "MAILING",
        "postalCode": "00000"
      }
    },
    "paymentCardType": "DEBIT",
    "cardNetwork": "MASTERCARD",
    "cardType": "PHYSICAL",
    "embossName": "Default user",
    "tokenFlags": "00010000000000000000000000000000",
    "pinSet": true,
    "status": "ISSUANCE_IN_PROGRESS",
    "cardText": "Waiting for Approval…",
    "maxPurchaseLimit": 100,
    "cardCategory": "STANDARD",
    "consumerType": "CONSUMER",
    "reportedCards": [],
    "processedAtThirdParty": false,
    "apiCallUniqueIdentifier": "ea0308ba-73c1-4d23-8f59-68886f6c2418",
    "createdAt": "2025-04-22T09:26:25.453+00:00",
    "updatedAt": "2025-07-04T05:20:37.638+00:00",
    "cardTokens": []
  }
}

Create Card Update Card Manufacturing