Get Payment Details API

This API allows merchants to retrieve payment details for a stored card token.

HTTP Method: GET

Environment

  • Production Environment: <info.storecard.service.url>/storecard/card/v1/cryptogram

Request headers

Parameter

Description

mid mandatory

Merchant ID provided by PayU. Use the value provided in your PayU dashboard.

Request body

Parameter

Description

userCredential mandatory

String Encrypted user credentials, typically <username>:<password>.

tokenType mandatory

StringType of token.

cardToken mandatory

StringToken for the card whose payment details are being fetched.

amount mandatory

StringAmount to validate or process for this payment.

currencyType mandatory

StringCurrency in which the payment is being processed.

Sample request

curl --location '<info.storecard.service.url>/storecard/card/v1/cryptogram' \
--header 'Content-Type: application/json' \
--header 'mid: 2' \
--data '{
    "userCredential": "sartaj:info",
    "tokenType": "PayUToken",
    "cardToken": "1817ca29b7cdd28a0e406",
    "amount": "10",
    "currencyType": "INR"
}'

Sample response

{
    "message": "Instrument details",
    "status": 1,
    "result": {
        "oneClickFlow": "",
        "oneClickStatus": "",
        "cardType": "AMEX",
        "trid": "400000340055",
        "networkToken": {
            "tokenValue": "3711110000000001",
            "tokenExpiryMonth": 10,
            "tokenExpiryYear": 2026
        },
        "cardMode": "",
        "par": "LI0K7PL4VJNHJZ6LVQ7LWXHGD3LPS",
        "tokenReferenceId": "a98d513e56cbc4ef2fdb603ceb1027b2",
        "cardNo": "XXXXXXXXXXXX1114",
        "oneClickCardAlias": "",
        "cardToken": "1817ca29b7cdd28a0e406",
        "cardName": "",
        "cryptogram": "AgAAAGQBdCZtW8sAmbHTg0UAAAA="
    }
}

Response parameters

ParameterDescriptionExample
messageResponse message indicating the operation result.Instrument details
statusStatus code for the operation. 1 for success, 0 for failure.1
resultResult of response in JSON format. For more information, refer to result JSON fields description

result JSON fields description

Field

Description

Example

cardType

Card type.

AMEX

trid

Transaction ID.

400000340055

networkToken

The field contains the following fields:

  • tokenValue: The actual card/network token.
  • tokenExpiryMonth: Token expiry month.
  • tokenExpiryYear: Token expiry year.

3711110000000001

par

Payment Account Reference.

LI0K7PL4VJNHJZ6LVQ7LWXHGD3LPS

cardNo

Masked card number.

XXXXXXXXXXXX1114

cardToken

Card token.

1817ca29b7cdd28a0e406

cryptogram

Generated encrypted string for payment security.

AgAAAGQBdCZtW8sAmbHTg0UAAAA=