Get Card Status
https://api-sandbox.letpay.io/token/card/PUBLIC_CARD_ID
Retrieves the status of a tokenized card.
Request Fields
None.
Response Fields
status(string): The tokenized card status. Valid options:PENDING,ACTIVE,INACTIVE.refresh_token(string): Updated access token for next calls.
| AUTHORIZATION | API Key |
|---|---|
| Key | X-Auth-Token |
| Value | MY_ACCESS_TOKEN |
Example Reques
- 200 - Success
- 401 - Unauthorized
- 404 - Not Found
Example Request
200 - Success
curl --location 'https://api-sandbox.letpay.io/token/card/PUBLIC_CARD_ID' \
--header 'X-Auth-Token: MY_ACCESS_TOKEN'
Example Response
Header
Content-Type: application/json
Body
{
"status": "ACTIVE",
"refresh_token": "MY_ACCESS_TOKEN"
}
Example Request
401 - Unauthorized
curl --location 'https://api-sandbox.letpay.io/token/card/PUBLIC_CARD_ID' \
--header 'X-Auth-Token: INVALID_ACCESS_TOKEN'
Example Response
Header
Content-Type: application/json
Body
{
"timestamp": "2024-01-16T19:52:18.186+0000",
"status": 401,
"error": "Unauthorized",
"message": "Access Denied",
"path": "/token/card/PUBLIC_CARD_ID"
}
Example Request
404 - Not Found
curl --location 'https://api-sandbox.letpay.io/token/card/INVALID_PUBLIC_CARD_ID' \
--header 'X-Auth-Token: MY_ACCESS_TOKEN'
Example Response
Header
Content-Type: application/json
Body
{
"timestamp": "2024-05-14T17:48:28.928+00:00",
"status": 404,
"error": "Not Found",
"message": "We can't find the card you are trying to use. Please verify and try again.",
"path": "/token/card/INVALID_PUBLIC_CARD_ID",
"errors": [
{
"code": "00.01.0034",
"description": "We can't find the card you are trying to use. Please verify and try again."
}
],
"refresh_token": "MY_ACCESS_TOKEN"
}