Get Customer Token by Token ID

GET/api/v1/customer/{customer_id}/tokens/{token_id}

Retrieve a specific token linked to a customer by both the customer ID and token ID.

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Path Parameters

Field	Details
`customer_id` `string`required	Unique identifier of the customer in the Pine Labs Online database.
`token_id` `string`required	Unique token ID to retrieve.

Header Parameters

Field	Details
`Request-Timestamp` `string`date-time	ISO 8601 UTC timestamp of the request. Used for idempotency and audit.
`Request-ID` `string`	Use a global unique identifier [GUID] for the request. Constraints Minimum length: 1 characterMaximum length: 50 characters

Response

Field	Details
`token_id` `string`	Unique token ID generated by Pine Labs Online.
`merchant_token_reference` `string`	Merchant's token reference.
`customer_id` `string`	Unique identifier of the customer.
`status` `string`	Current status of the token. INITIATED: Token creation is initiated. ACTIVE: Token is active and can be used for transactions. SUSPENDED: Token is temporarily suspended. FAILED: Token creation failed. DEACTIVATED: Token has been deactivated. Allowed values: `INITIATEDACTIVESUSPENDEDFAILEDDEACTIVATED`
`payment_method` `string`	Payment method associated with the token. Allowed values: `CARDUPIPOINTS`
`expired_at` `string`date-time	ISO 8601 UTC timestamp when the token expires.
`created_at` `string`date-time	ISO 8601 UTC timestamp when the token was created.
`updated_at` `string`date-time	ISO 8601 UTC timestamp when the token was last updated.
`status_reason` `string`	Reason for the current token status.
`merchant_metadata` `object`	Arbitrary key-value pairs for merchant use. Maximum 10 pairs, 256 characters each. Constraints Maximum properties: 10 Additional properties: string · Maximum length: 256 characters
`card_data` `object`9 nested fields	Card data associated with a token.
`last4_digit` `string`	Last 4 digits of the card number. Constraints Minimum length: 4 charactersMaximum length: 4 characters
`card_type` `string`	Type of card. Allowed values: `CREDITDEBIT`
`network_name` `string`	Card network name.
`issuer_name` `string`	Card issuer name.
`card_category` `string`	Category of the card.
`country_code` `string`	Country code of the card issuer.
`international` `boolean`	Whether the card is an international card.
`emi` `boolean`	Whether the card is eligible for EMI.
`cvv_required` `boolean`	Whether CVV is required for transactions with this token.
`is_compliant` `boolean`	Indicates whether the token is compliant with regulatory requirements.

Status Codes

`200`	Customer token details retrieved successfully.
`400`	The request was malformed or missing required fields.
`401`	Authentication failed — missing, expired, or invalid Bearer token.
`403`	The authenticated client does not have permission for this operation.
`404`	The requested resource does not exist.
`500`	An unexpected error occurred on the server.

Run

Request

curl --request GET \
  --url https://pluraluat.v2.pinepg.in/api/v1/customer/cust-v1-0811030624-aa-RBDgpR/tokens/token-v1-1234567890-aa-ABCDEF \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z'

Status:

{
  "token_id": "token-v1-1234567890-aa-ABCDEF",
  "merchant_token_reference": "token-ref-001",
  "customer_id": "cust-v1-0811030624-aa-RBDgpR",
  "status": "ACTIVE",
  "payment_method": "CARD",
  "expired_at": "2025-12-31T23:59:59.000000Z",
  "created_at": "2024-10-04T13:11:29.645591Z",
  "updated_at": "2024-10-04T13:11:29.645657Z",
  "status_reason": "Token activated successfully",
  "merchant_metadata": {
    "clientId": "DD",
    "transactionReferenceNo": "pine-1223",
    "merchantId": "1234",
    "tid": "9000990",
    "acquirerName": "HDFC_FSS",
    "isOfferDisplayRequired": "true",
    "OfferData": "UHJvZHVjdF9Db2RlPSIgIiZQcm9kdWN0X05hbWU9IiImUGF5bWVudF9Nb2RlPUJhbmsgRU1JJkNhcmRfVHlwZT1EZWJpdCBDYXJkJkJhbmtfTmFtZT1IREZDIERlYml0JkVNSV9UZW51cmU9NiZJbnRlcmVzdF9SYXRlPTkuMCZJbnRlcmVzdF9BbW91bnQ9MTM4MTQwJk1vbnRobHlfSW5zdGFsbG1lbnQ9ODk0NjkwJkF1dGhvcml6YXRpb25fQW1vdW50PTEwMCZMb2FuX2Jvb2tpbmdfQW1vdW50PTUyMzAwMDAmSW50ZXJlc3RfQ2FzaGJhY2tfQW1vdW50PTAmSW50ZXJlc3RfQ2FzaGJhY2tfVHlwZT1EZWZlcnJlZCZBZGRpdGlvbmFsX0Nhc2hiYWNrPSIiJkFkZGl0aW9uYWxfQ2FzaGJhY2tfVHlwZT0iIiZEZXNjcmlwdGlvbj1CYW5rIEVNSSZQcm9kdWN0X1ZhbHVlPTUyMzAwMDA",
    "tenant_id": "PGATPOS",
    "is_offer_validation_required": "true"
  },
  "card_data": {
    "last4_digit": "1112",
    "card_type": "CREDIT",
    "network_name": "Visa",
    "issuer_name": "HDFC Bank",
    "card_category": "CONSUMER",
    "country_code": "IN",
    "international": false,
    "emi": true,
    "cvv_required": true
  },
  "is_compliant": true
}