Get Additional Charge Info API

The Get Additional Charge Info API enables merchants to retrieve the applicable convenience fee for a payment transaction before the customer completes checkout. This API evaluates PayU pricing rules and returns the fee breakup (base amount, GST, and total) along with card BIN details, allowing merchants to display transparent pricing to customers.

Use Cases

• Display convenience fees to customers during checkout
• Calculate total payable amount including additional charges
• Retrieve card BIN details (card type, issuing bank, domestic/international status)
• Pre-validate pricing for different payment modes (Credit Card, Debit Card, EMI, Net Banking, etc.)

Endpoint

HTTP Method: POST

Content-Type: application/x-www-form-urlencoded

Sample Request

curl --location 'https://test.payu.in/merchant/postservice?form=2' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'key=smsplus' \
--data-urlencode 'command=get_additional_charge' \
--data-urlencode 'var1={"requestId":"abc1234","amount":10000,"category":"CC","bankCode":"CC","cardNo":"45678930013904","bin":"456789"}' \
--data-urlencode 'hash=c9c2440160a75303e1d272044dbfa5c1e5a13b225dcac11f69a9079491cf2660fd79f32e1e9c05c903ec1cc8ad0746b3989c20f922d32aab1dd124206ccdc5a1'

Note: Replace key, var1 payload values, and hash with your actual merchant credentials and computed hash before making the request.

Request Parameters

Hash Generation

The hash parameter ensures request integrity and authenticity. It must be computed on the server-side using SHA-512.

Hash Sequence

key|command|var1|salt

Sample hash generation code

<?php
$key = "smsplus";
$command = "get_additional_charge";
$var1 = '{"requestId":"abc1234","amount":10000,"category":"CC","bankCode":"CC","bin":"456789"}';
$salt = "your_merchant_salt";

$hashString = $key . '|' . $command . '|' . $var1 . '|' . $salt;
$hash = strtolower(hash('sha512', $hashString));

echo $hash;
?>

import hashlib

key = "smsplus"
command = "get_additional_charge"
var1 = '{"requestId":"abc1234","amount":10000,"category":"CC","bankCode":"CC","bin":"456789"}'
salt = "your_merchant_salt"

hash_string = f"{key}|{command}|{var1}|{salt}"
hash_value = hashlib.sha512(hash_string.encode('utf-8')).hexdigest().lower()

print(hash_value)

var1 JSON Object Fields Description

The var1 parameter must be a JSON-encoded string containing the following fields:

Sample Response

Success Response

{
  "status": 1,
  "details": {
    "requestId": "abc1234",
    "amount": 10000,
    "additionalChargeBase": 236,
    "additionalChargeGst": 42,
    "additionalChargeTotal": 278,
    "cardBinDetails": {
      "card_type": "CREDIT",
      "issuing_bank": "HDFC Bank",
      "is_domestic": true
    }
  }
}

Error Response

{
  "status": 0,
  "msg": "mandatory param requestId is missing",
  "errorCode": "MANDATORY_PARAMS_MISSING"
}

Response Parameters

Success Response (status = 1)

details Object

cardBinDetails Object

Error Response (status = 0)

Error Codes

Notes

1. Amount Format: All monetary values (amount, additionalChargeBase, additionalChargeGst, additionalChargeTotal) are in paise for INR. Divide by 100 to get the rupee value.

2. Display to Customer: Use the additionalChargeTotal to show the total convenience fee to customers during checkout. Example:

   Order Amount: ₹100.00
   Convenience Fee: ₹2.78
   Total Payable: ₹102.78

3. Card Details: The cardBinDetails object is useful for:

   • Displaying card issuer to the customer
   • Applying different pricing for domestic vs. international cards
   • Validation and fraud prevention

4. Error Handling: Always check the status field first. If status = 0, parse the errorCode for programmatic handling and display the msg to help debug the issue.

5. Request Uniqueness: Use a unique requestId (UUID recommended) for each API call to ensure idempotency and aid in troubleshooting.

Testing

Use the test environment URL with your test merchant credentials:

• Test URL: https://test.payu.in/merchant/postservice?form=2
• Test Card BINs: Use standard test card numbers provided by PayU to simulate different scenarios

Test Scenarios to Validate

Support

For technical assistance or questions about this API:

• Merchant Dashboard: https://merchant.payu.in
• Integration Support: [email protected]
• Developer Documentation: https://docs.payu.in