Fetch Forex Charges for Currency Conversion

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET "https://api.razorpay.com/v1/forex_charges?amount=1000000&base_currency=INR&conversion_currency=USD"

{
  "amount": 1000000,
  "base_currency": "INR",
  "conversion_currency": "USD",
  "converted_amount": 11388,
  "expiry_time": 1782363756
}

{
  "error": {
    "code": "BAD_REQUEST_ERROR",
    "description": "The amount must be an integer.",
    "source": "business",
    "step": null,
    "reason": "input_validation_failed",
    "metadata": {},
    "field": "amount"
  }
}

{
  "error": {
    "code": "BAD_REQUEST_ERROR",
    "description": "Authentication failed"
  }
}

GET

forex_charges

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET "https://api.razorpay.com/v1/forex_charges?amount=1000000&base_currency=INR&conversion_currency=USD"

{
  "amount": 1000000,
  "base_currency": "INR",
  "conversion_currency": "USD",
  "converted_amount": 11388,
  "expiry_time": 1782363756
}

{
  "error": {
    "code": "BAD_REQUEST_ERROR",
    "description": "The amount must be an integer.",
    "source": "business",
    "step": null,
    "reason": "input_validation_failed",
    "metadata": {},
    "field": "amount"
  }
}

{
  "error": {
    "code": "BAD_REQUEST_ERROR",
    "description": "Authentication failed"
  }
}

Available in🇮🇳 India

Use this endpoint to fetch the converted amount for a currency pair. The response also provides the time until which the foreign exchange rate is valid.

Authentication

This endpoint supports Private Auth and Partner Auth. Use Basic Auth with the applicable key ID and key secret. Know more about API authentication.

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET "https://api.razorpay.com/v1/forex_charges?amount=1000000&base_currency=INR&conversion_currency=USD"

{
  "amount": 1000000,
  "base_currency": "INR",
  "conversion_currency": "USD",
  "converted_amount": 11388,
  "expiry_time": 1782363756
}

{
  "error": {
    "code": "BAD_REQUEST_ERROR",
    "description": "The amount must be an integer.",
    "source": "business",
    "step": null,
    "reason": "input_validation_failed",
    "metadata": {},
    "field": "amount"
  }
}

{
  "error": {
    "code": "BAD_REQUEST_ERROR",
    "description": "Authentication failed"
  }
}

Query Parameters

integer

required

Amount to convert, in the smallest currency unit. For example, 1000000.

string

required

Currency of the amount you want to convert. For example, INR.

string

required

Currency into which you want to convert the amount. For example, USD.

Response Parameters

integer

Amount requested for conversion, in the smallest currency unit. For example, 1000000.

string

Currency of the amount requested for conversion. For example, INR.

string

Currency into which the amount is converted. For example, USD.

integer

Converted amount after applying the foreign exchange rate, in the smallest currency unit. For example, 11388.

integer

Unix timestamp at which the foreign exchange rate expires. For example, 1782363756.

​Authentication

​Query Parameters

​Response Parameters

Authentication

Query Parameters

Response Parameters