Orders

Razorpay enables you to create orders that can be linked to payments. It is recommended to associate every payment with an order as it helps in:

Preventing multiple payments.
Automatically capturing payments.

This section contains the details of the Orders APIs that are used to create orders, fetch details of orders and payments made towards these orders.

Integrations:
Looking to integrate your website, ecommerce store or mobile app with Razorpay Payment Gateway? Visit our Introduction to Razorpay page to find the right integration method for you.

If you want to directly integrate with our APIs, reach out to our Support team with your requirements.

You can also collect payments without a website or app, using Razorpay products, such as Payment Links, Payment Pages, Subscription Links, Invoices and Smart Collect.

Order Entity#

The order entity consists of the following fields:

id: string The unique identifier of the order.
amount: integer The amount for which the order was created, in currency subunits. For example, for an amount of INR 295, enter 29500.
amount_paid: integer The amount paid against the order.
amount_due: integer The amount pending against the order.
currency: string The currency associated with the order's amount. Refer the list of supported currencies.
receipt: string Your receipt id corresponding to this order. Maximum length 40 chars.
status: string The status of the order.
Possible values:
- created
- attempted
- paid Note:
An order moves from created to attempted state when a payment request is first made on that order. It remains in the attempted state till all payments associated with that order, including partial payments, are captured. After the successful capture of the payment, order moves to the paid state. No further payment requests are permitted after the order attains the paid state.
attempts: integer The number of payment attempts, successful and failed, that have been made against this order.
payment_capture: boolean Flag for capturing the payment.
If the value is set to 1, the payment is automatically captured. If the value is set to 0 (default value), the payment should be captured manually.

Note: To learn about manually capturing the payments, refer Capturing Payments.
created_at: integer Indicates the UNIX timestamp when this order was created.
notes: json object Object consisting of notes passed while creating an order entity.

 Sample Entity
Copy{
  "id":"order_DaZlswtdcn9UNV",
  "entity":"order",
  "amount":50000,
  "amount_paid":0,
  "amount_due":50000,
  "currency":"INR",
  "receipt":"Receipt #20",
  "status":"created",
  "attempts":0,
  "notes":[],
  "created_at":1572502745
}

Create an Order#

The following endpoint creates an order:

/orders

Below are sample requests for creating an order:

 Request Java Python PHP dotnet Ruby Node.JS Response
Copycurl -u <YOUR_KEY_ID>:<YOUR_SECRET> \
    https://api.razorpay.com/v1/orders
    -X POST \
    --data "amount=50000" \
    --data "currency=INR" \
    --data "receipt=rcptid #1" \
    --data "payment_capture=1" \
    https://api.razorpay.com/v1/orders

Copytry {
  JSONObject orderRequest = new JSONObject();
  orderRequest.put("amount", 50000); // amount in the smallest currency unit
  orderRequest.put("currency", "INR");
  orderRequest.put("receipt", "order_rcptid_11");
  orderRequest.put("payment_capture", true);

  Order order = razorpay.Orders.create(orderRequest);
} catch (RazorpayException e) {
  // Handle Exception
  System.out.println(e.getMessage());
}

Copyorder_amount = 50000
order_currency = 'INR'
order_receipt = 'order_rcptid_11'
notes = {'Shipping address': 'Bommanahalli, Bangalore'}   # OPTIONAL

client.order.create(amount=order_amount, currency=order_currency, receipt=order_receipt, notes=notes, payment_capture='1')
Copy$order  = $client->order->create([
  'receipt'         => 'order_rcptid_11',
  'amount'          => 50000, 
  'currency'        => 'INR',
  'payment_capture' =>  '1'
]);

CopyDictionary<string, object> options = new Dictionary<string,object>();
options.Add("amount", 50000); // amount in the smallest currency unit
options.add("receipt", "order_rcptid_11");
options.add("currency", "INR");
options.add("payment_capture", "1");
Order order = client.Order.Create(options);

Copyoptions = amount: 50000, currency: 'INR', receipt: '<order_rcptid_11>', payment_capture: '1'
order = Razorpay::order.create

Copyvar options = {
  amount: 50000,  // amount in the smallest currency unit
  currency: "INR",
  receipt: "order_rcptid_11",
  payment_capture: '1'
};
instance.orders.create(options, function(err, order) {
  console.log(order);
});

Copy{
  "id":"order_DaZlswtdcn9UNV",
  "entity":"order",
  "amount":50000,
  "amount_paid":0,
  "amount_due":50000,
  "currency":"INR",
  "receipt":"Receipt #20",
  "status":"created",
  "attempts":0,
  "notes":[],
  "created_at":1572502745
}

Request Parameters#

Following are the parameters that can be passed in the request body:

amount mandatory: integer The amount for which the order was created, in currency subunits. For example, for an amount of INR 295, enter 29500. Payment can only be made for this amount against the order.
currency mandatory: string ISO code for the currency in which you want to accept the payment. Refer the list of supported currencies.
receipt optional: string You can set a receipt id for your internal reference against this order. Maximum length 40 characters.
payment_capture optional: boolean Payment capture flag for automatically capturing payment. Set to 1 to enable automatic capture. Set to 0 for manual capture. Learn how to capture the payment manually using API or from the Razorpay Dashboard.
notes optional: json object Object consisting of key value pairs as notes. To read more, refer Notes.

Fetch Orders#

The following endpoint retrieves the details of all orders created by you:

/orders

In this example, count and skip query parameters have been used. You can invoke this API without these query parameters as well.

 Request Java Python Response
Copy  curl -u <YOUR_KEY_ID>:<YOUR_SECRET>\
  -X GET https://api.razorpay.com/v1/orders?count=2&skip=1 \

Copyimport java.util.List;
import com.razorpay.Order;
import org.json.JSONObject;
import com.razorpay.RazorpayClient;
import com.razorpay.RazorpayException;

RazorpayClient razorpay = new RazorpayClient("<api_key>", "<api_secret>");
try {
  JSONObject orderRequest = new JSONObject();

  // supported option filters (from, to, count, skip)
  orderRequest.put("count", 2);
  orderRequest.put("skip", 1);

  List<Order> orders = razorpay.Orders.fetchAll(orderRequest);
} catch (RazorpayException e) {
  // Handle Exception
  System.out.println(e.getMessage());
}
Copy# do easy_install razorpay or
#    pip install razorpay

import razorpay

razorpay.Client(auth=("<YOUR_KEY_ID>", "<YOUR_KEY_SECRET>"))

resp = client.order.fetch_all()
Copy{
  "entity":"collection",
  "count":2,
  "items":[
    {
      "id":"order_DaaJNqPxHAprlj",
      "entity":"order",
      "amount":1500,
      "amount_paid":1500,
      "amount_due":0,
      "currency":"INR",
      "receipt":"Receipt #21",
      "offer_id":null,
      "status":"paid",
      "attempts":1,
      "notes":[],
      "created_at":1572504648
    },
    {
      "id":"order_DaaDzASllNdTNt",
      "entity":"order",
      "amount":500,
      "amount_paid":0,
      "amount_due":500,
      "currency":"INR",
      "receipt":"rcptid #1",
      "offer_id":null,
      "status":"created",
      "attempts":0,
      "notes":[],
      "created_at":1572504341
    }
  ]
}

Request Parameters#

authorized optional: boolean Set to 1 to retrieve orders for which payments are currently in authorized state.
receipt optional: string Retrieves the orders that contain the provided value for receipt.

Query Parameters#

from optional: integer UNIX Timestamp from when orders are to be fetched.
to optional: integer UNIX Timestamp up till when orders are to be fetched.
count optional: integer Number of orders to be fetched. Default count is 10.
skip optional: integer Numbers of orders to be skipped. Default skip is 0.

Fetch an Order with Id#

The following endpoint retrieves the details of a particular order:

/orders/:id

 Request Java Python Response
Copycurl -u <YOUR_KEY_ID>:<YOUR_SECRET>\
-X GET https://api.razorpay.com/v1/orders/order_DaaS6LOUAASb7Y \
Copyimport com.razorpay.Order;
import com.razorpay.RazorpayClient;
import com.razorpay.RazorpayException;

RazorpayClient razorpay = new RazorpayClient("<api_key>", "<api_secret>");
try {
  Order order = razorpay.Orders.fetch("<order_id>");
} catch (RazorpayException e) {
  // Handle Exception
  System.out.println(e.getMessage());
}
Copy# do easy_install razorpay or
#    pip install razorpay

import razorpay

razorpay.Client(auth=("<YOUR_KEY_ID>", "<YOUR_KEY_SECRET>"))

order_id = <ORDER_ID>

resp = client.order.fetch(order_id)
Copy{
  "id":"order_DaaS6LOUAASb7Y",
  "entity":"order",
  "amount":2200,
  "amount_paid":0,
  "amount_due":2200,
  "currency":"INR",
  "receipt":"Receipt #211",
  "status":"attempted",
  "attempts":1,
  "notes":[],
  "created_at":1572505143
}

Path Parameter#

id mandatory: string Unique identifier of the order to be retrieved.

Fetch Payments for an Order#

You can retrieve all the payments made for an order. The response contains multiple payment attempts, authorized and failed, for that order.

/orders/:id/payments

 Request Response
Copycurl -u <YOUR_KEY_ID>:<YOUR_SECRET>\ 
-X GET https://api.razorpay.com/v1/orders/order_DaaS6LOUAASb7Y/payments \
Copy{
  "entity":"collection",
  "count":1,
  "items":[
    {
      "id":"pay_DaaSOvhgcOfzgR",
      "entity":"payment",
      "amount":2200,
      "currency":"INR",
      "status":"captured",
      "order_id":"order_DaaS6LOUAASb7Y",
      "invoice_id":null,
      "international":false,
      "method":"card",
      "amount_refunded":0,
      "refund_status":null,
      "captured":true,
      "description":"Beans in every imaginable flavour",
      "card_id":"card_DZon6fd8J3IcA2",
      "bank":null,
      "wallet":null,
      "vpa":null,
      "email":"gaurav.kumar@example.com",
      "contact":"+919999999988",
      "notes":[],
      "fee":44,
      "tax":0,
      "error_code":null,
      "error_description":null,
      "created_at":1572505160
    }
  ]
}

Path Parameter#

id mandatory: string Unique identifier of the order for which the payments should be retrieved.

Update the Order#

You can modify an existing order to update the Notes field only. Notes can be used to record additional information about the order. The notes field is a key-value store and can have a maximum of 15 key-value pairs, each of 256 characters (maximum).

Using the PATCH operation, you can replace the entire notes object for the entity.

To modify the notes field in a particular order, construct the API request as follows:

/orders/:id/

 Request Response
Copycurl -u <YOUR_KEY_ID>:<YOUR_SECRET>\ 
-X PATCH https://api.razorpay.com/v1/orders/order_DaaS6LOUAASb7Y \
-d 'notes[key1]=value3' \
-d 'notes[key2]=value2' \
Copy{
  "id":"order_DaaS6LOUAASb7Y",
  "entity":"order",
  "amount":2200,
  "amount_paid":0,
  "amount_due":2200,
  "currency":"INR",
  "receipt":"Receipt #211",
  "offer_id":null,
  "status":"attempted",
  "attempts":1,
  "notes":{
    "key1":"value3",
    "key2":"value2"
  },
  "created_at":1572505143
}

Request Parameter#

notes mandatory: json object Notes of the entity to be modified. Learn more about notes.

Path Parameter#

id mandatory: string Unique identifier of the order in which the Notes field must be updated.