Get Card Request Status

Retrieves the status of a card operation(ISSUE, TOPUP, WITHDRAWAL, BLOCK) request using either request ID or document ID.

Endpoint: GET /request/status

Query Parameters:

Parameter	Type	Required	Description
request_id	String	Conditional	Unique request identifier
docid	Number	Conditional	Document ID

Note: Either request_id or docid must be provided.

Response (Block Operation):

{
  "type": "BLOCK",
  "status": "EXECUTED",
  "docid": 123456,
  "request_id": "request-id-12345",
  "created": "2025-07-03T09:21:55.605Z",
  "block": {
    "san": "1234567890",
    "releasedBalance": 150.75,
    "currency": "USD"
  }
}

Response Parameters (Block Operation):

Field	Type	Description
type	String	Operation type (BLOCK)
status	String	Current status of the operation (see Status Values below)
docid	Number	Document ID for tracking the operation
request_id	String	The request ID provided in the original request
block	Object	Block operation details
block.san	String	Secure Account Number (card identifier)
block.releasedBalance	Decimal	Balance released back to user account after blocking
block.currency	String	Currency code (USD, EUR, etc.)

Response (Top-Up Operation):

{
  "type": "TOPUP",
  "status": "EXECUTED",
  "docid": 123456,
  "request_id": "request-id-12345",
  "created": "2025-07-03T09:21:55.605Z",
  "topup": {
    "san": "1234567890",
    "amount": 100.00,
    "currency": "USD"
  }
}

Response Parameters (Top-Up Operation):

Field	Type	Description
type	String	Operation type (TOPUP)
status	String	Current status of the operation (see Status Values below)
docid	Number	Document ID for tracking the operation
request_id	String	The request ID provided in the original request
topup	Object	Top-up operation details
topup.san	String	Secure Account Number (card identifier)
topup.amount	Decimal	Amount added to the card
topup.currency	String	Currency code (USD, EUR, etc.)

Response (Issue Operation):

{
  "type": "ISSUE",
  "status": "EXECUTED",
  "docid": 123456,
  "request_id": "request-id-12345",
  "created": "2025-07-03T09:21:55.605Z",
  "issue": {
    "san": "1234567890",
    "pan": "************5678",
    "expYear": 2026,
    "expMonth": 12,
    "cvv": "123",
    "currency": "USD",
    "initialBalance": 100.00,
    "cardName": "My Card"
  }
}

Response Parameters (Issue Operation):

Field	Type	Description
type	String	Operation type (ISSUE)
status	String	Current status of the operation (see Status Values below)
docid	Number	Document ID for tracking the operation
request_id	String	The request ID provided in the original request
issue	Object	Issue operation details
issue.san	String	Secure Account Number (card identifier)
issue.pan	String	Masked Primary Account Number
issue.expYear	Number	Card expiration year
issue.expMonth	Number	Card expiration month (1-12)
issue.cvv	String	Card verification value
issue.currency	String	Card currency code
issue.initialBalance	Decimal	Initial balance loaded on the card
issue.cardName	String	Custom name assigned to the card

Response (Withdrawal Operation):

{
  "type": "WITHDRAWAL",
  "status": "EXECUTED",
  "docid": 123456,
  "request_id": "request-id-12345",
  "created": "2025-07-03T09:21:55.605Z",
  "withdrawal": {
    "san": "1234567890",
    "amount": 50.00,
    "currency": "USD"
  }
}

Response Parameters (Withdrawal Operation):

Field	Type	Description
type	String	Operation type (WITHDRAWAL)
status	String	Current status of the operation (see Status Values below)
docid	Integer	Document ID for tracking the operation
request_id	String	The request ID provided in the original request
withdrawal	Object	Withdrawal operation details
withdrawal.san	String	Secure Account Number (card identifier)
withdrawal.amount	Decimal	Amount withdrawn from the card
withdrawal.currency	String	Currency code (USD, EUR, etc.)

Operation Types:

• ISSUE - Card issuance

• TOPUP - Card top-up

• WITHDRAWAL - Card withdrawal

• BLOCK - Card blocking

Status Values:

• INPROCESS - Operation is being processed

• EXECUTED - Operation completed successfully

• DECLINED - Operation was declined for some reason