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 →

Request Body

Name	Type	Description
`amount`	`string`	Transaction amount in smallest currency unit.
`card_details`	`CardDetailLookupItem[]`required	An array that contains the card details.
`payment_identifier`	`string`required	Card Number. Minimum length: 12 characters. Maximum length: 19 characters. Supported characters: 0-9
`payment_reference_type`	`CARD \| ALT_TOKEN_TXN \| NETWORK_TOKEN_TXN \| ISSUER_TOKEN_TXN`required	Type of payment method you want to use to accept a payment. `CARDALT_TOKEN_TXNNETWORK_TOKEN_TXNISSUER_TOKEN_TXN`

Response

Name	Type	Description
`card_payment_details`	`CardPaymentDetailItem[]`	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`
`422`	Unprocessable entity — invalid card number format.
`500`
`503`	Service temporarily unavailable.

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' \
  --data '{
  "amount": "100",
  "card_details": [
    {
      "payment_identifier": "4012001037141112",
      "payment_reference_type": "CARD"
    }
  ]
}'

Run this request

Bearer token

Request body (JSON)

200 OK

{
  "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
    }
  ]
}