Currency Conversion
Know how currency conversion works in the APIs, Razorpay Dashboard and Settlements.
Razorpay Settlements occur in INR based on the conversion rate at the time of payment.
On the checkout form or when using APIs for Razorpay products such as Orders, Payment Links, Subscriptions or Invoices, you need to specify the desired currency and pass the amount in the currency subunit.
The following is a sample API request and response to create an order for $20:
curl -u <YOUR_KEY>:<YOUR_SECRET> \-X POST https://api.razorpay.com/v1/orders \-H "content-type: application/json"-d '{"amount": 2000,"currency": "USD","receipt": "rcptid #11"}'
currency
mandatory
string
Currency in which you want to accept the payment. For example, GBP
. Check the
amount
mandatory
integer
The amount to be charged in the specified currency subunit.
For example, when selling a product for ₹1000 in the domestic market, you pass INR
in the currency
parameter and 100000
in the amount
parameter (since the amount should be in paise).
When selling in the international market, you might want to charge $20 for the same product. In this case, you must pass USD
in the currency
parameter and 2000
in the amount
parameter (since the amount should be in cents).
The
will contain additional fields when the currency is not INR to provide visibility into the conversion rate.Example
The following is a sample payment entity for a $1 payment:
{"id": "pay_Donb2t6WkJYhfU","entity": "payment","amount": 100,"currency": "USD","base_amount": 7129,"base_currency": "INR","status": "captured","order_id": "order_CjCr5oKh4AVC51","international": true,"method": "card","amount_refunded": 0,"refund_status": null,"description": "Payment at the Dollar Store","card_id": "card_Donb2wk8eC8EDN","email": "gaurav.kumar@example.com","contact": "9364591752","notes": [],"fee": 207,"tax": 0,"error_code": null,"error_description": null,"created_at": 1400826750}
base_currency
string
The conversion currency that will be used to calculate fees and settlements. This currently defaults to INR and is present only if the currency
is not INR.
base_amount
integer
The converted payment amount that will be used to calculate fees and settlements. Represented in the smallest unit of the base_currency
. This attribute is currently only present if the currency
is not INR.
When using products such as Payment Links or Subscription Links, ensure you select the desired currency from the currency drop-down list and add the amount in the selected currency. For example, if you want to charge $20 when selling in the international market, select USD
in the Currency drop-down list and enter 20 in the Amount field.
Watch this video to see how to select the international currency from the dashboard.
After your customers have made the payment, the payment amount is converted to INR and settled to your Razorpay Payment Gateway (PG) account as per your settlement schedule. The exchange rate (according to the processing bank) on the date the payment was made is used to make the conversion.
A customer made a payment of $10 on February 02, 2019.
- Settlement Schedule: T+7 business days for domestic transactions, where T is the date of capture of payment.
- Date of payment capture: February 02, 2019
- Conversion Rate: $1 = ₹70 as on February 02, 2019
- Settlement Amount: For $10 payment, $10 * ₹70= 700 (minus taxes and fees) is settled to your account on February 09, 2019.
Was this page helpful?