Skip to main content
POST
/
utilities
/
pars
Get PAR
curl --request POST \
  --url https://sandbox.cashfree.com/pg/utilities/pars \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "card_number": "4111111111111111",
  "card_cvv": "123",
  "card_expiry_mm": "12",
  "card_expiry_yy": "27",
  "card_type": "PLAIN_CARD"
}'
{
  "par": "V0010014623022637739353641436"
}

Authorizations

ā€‹
x-client-id
string
header
required

Client app ID. You can find your app id in the merchant dashboard.

ā€‹
x-client-secret
string
header
required

Client secret key. You can find your secret key in the merchant dashboard.

Headers

ā€‹
x-api-version
string
default:2025-01-01
required

API version to be used. Format is in YYYY-MM-DD.

ā€‹
x-request-id
string

Request id for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to Cashfree.

ā€‹
x-idempotency-key
string<UUID>

An idempotency key is a unique identifier you include with your API call. If the request fails or times out, you can safely retry it using the same key to avoid duplicate actions.

Body

application/json

Request payload for creating PAR.

ā€‹
card_number
string
required

The card number, containing 15 to 19 numeric digits without spaces or special characters.

Example:

"4111111111111111"

ā€‹
card_cvv
string
required

The Card Verification Value (CVV), a 3-digit code for most cards (Visa, Mastercard) and a 4-digit code for American Express, used for transaction authentication.

Example:

"123"

ā€‹
card_expiry_mm
string
required

The two-digit expiry month (01-12), indicating when the card will expire.

Example:

"12"

ā€‹
card_expiry_yy
string
required

The two-digit expiry year, representing the last two digits of the cardā€™s expiration year.

Example:

"27"

ā€‹
card_type
enum<string>
required

Specifies the type of card, with the only accepted value being PLAIN_CARD.

Available options:
PLAIN_CARD

Response

Response body to get PAR by providing plain card details.

ā€‹
par
string

PAR for plain card sent in request.

Example:

"V0010014623022637739353641436"