Using Card Tokenized with PayU

If the merchant has tokenized the card with PayU and needs to process the transaction using PayU token only.

HTTP Method: POST

Environment

Applicable scenarios

  • Merchant has created the token using PayU as the partner

📘

Note

This scenario is applicable if any PCI or Non-PCI complied merchant sends the PayU token in a request for fulfilment purposes.

Request parameters

**Parameter** **Description** **Example**
key **mandatory** `String` The merchant key is a unique identifier for a merchant account in PayU's database. Your Test Key
api_version **optional** `String` The API version for this API. 1
txnid **mandatory** `String` The transaction ID is a reference number for a specific order that is generated by the merchant. It is used to track the order and must be unique. PayU's system will not accept duplicate transaction IDs. s7hhDQVWvbhBdN
amount **mandatory** `String` This field should contain the payment amount for the transaction. If you want to use the cardless EMI option, the amount must be at least Rs. 8000 10.00
productinfo **mandatory** `String` It should be a string containing a brief description of the product. iPhone
firstname **mandatory** `String` The first name of the customer. Ashish
email **mandatory** `String` The email of the customer. [[email protected]](mailto:[email protected])
phone **mandatory** `String` The phone number of the customer. * **Note**: This information is helpful when it comes to issues related to fraud detection and chargebacks. Hence, it is must to provide the correct information. 9876543210
lastname **mandatory** `String` The last name of the customer. Verma
address1 **optional** `String` The first line of the billing address. H.No- 17, Block C, Kalyan Bldg, Khardilkar Road, Mumbai
address2 **optional** `String` The second line of the billing address. Character Limit-100 34 Saikripa-Estate, Tilak Nagar
city **optional** `String` The city where your customer resides as part of the billing address. Mumbai
state **optional** `String` The state where your customer resides as part of the billing address, Maharashtra
country **optional** `String` The country where your customer resides. Character Limit-50 India
zipcode **optional** `String` Billing address zip code is mandatory for the cardless EMI option. 400004
surl **mandatory** `String` The "surl" field is the success URL, which is the page PayU will redirect to if the transaction is successful. The merchant can handle the response at this URL after the customer is redirected there. [https://apiplayground-response.herokuapp.com/](https://apiplayground-response.herokuapp.com/)
furl **mandatory** `String` The "furl" field is the Failure URL, which is the page PayU will redirect to if the transaction is failed. The merchant can handle the response at this URL after the customer is redirected there. [https://apiplayground-response.herokuapp.com/](https://apiplayground-response.herokuapp.com/)
hash **mandatory** `String` It is used to avoid the possibility of transaction tampering. For more information on hash generation process, refer to [Generate Hash](doc:generate-hash-merchant-hosted). `eabec285da28fd0e3054d41a4d24fe9f7599c9d0b66646f7a9984303fd6124044b6206daf831e9a8bda28a6200d318293a13d6c193109b60bd4b4f8b09c90972`
pg **mandatory** `String` The pg parameter determines which payment tabs will be displayed. Here, use 'CC' as the value. CC
bankcode **mandatory** `String` Each payment option is identified with a unique bank code at PayU. The merchant must post this parameter with the corresponding payment option’s bank code value in it. AMEX
udf1 - udf5 **optional** `String` User-defined fields (udf) are used to store any information corresponding to a particular transaction. You can use up to five udfs in the post designated as udf1, udf2, udf3, udf4, udf5. Character Limit-255 Payment Preference, Shipping Method, Shipping Address1, Shipping City, Shipping Zip Code, etc.
ccvv **optional** `varchar` This parameter must contain the CVV number of the card – as entered by the customer for the transaction. 123
storecard_token_type **mandatory** `integer` This parameter is used to specify the store card token type. For this scenario, you must include 0. 0
user_credentials **mandatory** `varchar` This parameter must contain the user credentials. a:b
store_card_token **mandatory** `varchar` This must include the token generated by PayU for the card. 1234 4567 2456 3566

Response

The response is similar to plain card details.