Get Card Details

POST/api/pay/v1/getCardDetails

Use this API to get the card details.

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

Requires Bearer token. Get token →

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

Request Bodyrequired

Field	Details
`amount` `string`	Transaction amount in smallest currency unit.
`card_details` `CardDetailLookupItem[]`required2 nested fields	An array that contains the card details. Constraints Minimum items: 1

Response

Field	Details
`card_payment_details` `CardPaymentDetailItem[]`9 nested fields	Array of card payment details matching the lookup.
`card_network` `string`	Card network provider.
`card_issuer` `string`	Card issuing bank or institution.
`card_type` `string`	Type of card.
`card_category` `string`	Card category.
`is_international_card` `boolean`	Whether the card is an international card.
`is_native_otp_supported` `boolean`	Whether the card supports native OTP flow.
`country_code` `string`	Country code of the card issuer.
`currency` `string`	Currency associated with the card.
`is_currency_supported` `boolean`	Whether the card's currency is supported for transactions.

Status Codes

`200`	Card details retrieved successfully.
`400`	The request was malformed or missing required fields.
`422`	Unprocessable entity — invalid card number format.
`500`	An unexpected error occurred on the server.
`503`	Service temporarily unavailable.

Run

Request

curl --request POST \
  --url https://pluraluat.v2.pinepg.in/api/pay/v1/getCardDetails \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z' \
  --data '{
  "amount": "100",
  "card_details": [
    {
      "payment_identifier": "4012001037141112",
      "payment_reference_type": "CARD"
    }
  ]
}'

Status:

{
  "card_payment_details": [
    {
      "card_network": "VISA",
      "card_issuer": "INTL HDQTRS-CENTER OWNED",
      "card_type": "CREDIT",
      "card_category": "NONE",
      "is_international_card": false,
      "is_native_otp_supported": true,
      "country_code": "IND",
      "currency": "INR",
      "is_currency_supported": true
    }
  ]
}