Get Card Status

Retrieve the current status of a registered card.

POST

***

Request Parameters

Name	Type	Description
`public_key`Required	`String`	Merchant identifier. Example: `i000000001`
`card_id`Required	`String`	Card identifier. Example: `ce00000001`

Request Example

Send Request

Payload

{
  "public_key": "i000000001",
  "card_id": "ce00000001"
}

1DATA=$(echo -n '{"public_key":"i000000001","card_id":"ce00000001"}' | base64)
2SIGNATURE=$(echo -n "$PRIVATE_KEY$DATA$PRIVATE_KEY" | openssl dgst -sha1 -binary | base64)
3
4curl -X POST *** \
5-H "Content-Type: application/x-www-form-urlencoded" \
6-d "data=$DATA&signature=$SIGNATURE"

Response Parameters

Name	Type	Description
`id`Required	`String`	Card identifier
`name`Required	`String`	Cardholder name
`mask`Required	`String`	Card mask in `123456******1234` format
`status`Required	`String`	Card status: `new`, `active`, `pending`, `rejected`, `expired`, `session_expired`
`expired_date`Required	`String`	Card expiration date in `mm/yy` format
`description`Optional	`String`	Additional description
`trace_id`Required	`String`	Unique request identifier for debugging. Provide this to Epoint support for issue investigation.

Success

Success Response
{
  "id": "ce00000001",
  "name": "John Doe",
  "mask": "123456******1234",
  "status": "active",
  "expired_date": "12/26",
  "description": null,
  "trace_id": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"
}