Skip to main content

Step 1: Create an Order

Order creation is the first step to integrate your application with Razorpay and start accepting payments. Orders API allows you to create an Order when a payment is expected from a customer. Ensure the razorpay_order_id is stored against the corresponding transaction. The API endpoint given below will create an Order at your server-side: /orders Order is an important step in the payment process.
  • An order should be created for every payment.
  • You can create an order using the Orders API. It is a server-side API call. Know how to authenticate Orders API.
  • The order_id received in the response should be passed to the checkout. This ties the Order with the payment and secures the request from being tampered.
Watch Out!Payments made without an order_id cannot be captured and will be automatically refunded. You must create an order before initiating payments to ensure proper payment processing.

API Sample Code

The following is a sample API request and response for creating an order:
Curl

Request Parameters

Here is the list of parameters and their description for creating an order: amount mandatory : integer The transaction amount, expressed in the currency subunit. For example, for an actual amount of 299.35, the value of this field should be 29935. currency mandatory : string The currency in which the transaction should be made. See the list of supported currencies. Length must be 3 characters. receipt optional : string Your receipt id for this order should be passed here. Maximum length is 40 characters. notes optional : json object Key-value pair that can be used to store additional information about the entity. Maximum 15 key-value pairs, 256 characters (maximum) each. For example, "note_key": "Beam me up Scotty”. partial_payment optional : boolean Indicates whether the customer can make a partial payment. Possible values:
  • true: The customer can make partial payments.
  • false (default): The customer cannot make partial payments.
id optional : string Unique identifier of the customer. For example, cust_1Aa00000000004. Know more about Orders API.

Error Response Parameters

The error response parameters are available in the API Reference Guide.

Step 2: Create a Payment

Use the order_id, that is the id returned in the previous step to create a payment. The API endpoint given below creates a payment using cards. Your customers can make payments by providing either card details or the token id.

Pay using Cards

Use the following endpoint to make payment using card details. /payments/create/redirect
Request

Pay using Tokens

According to recent Payment Acquirer (PA)/ Payment Gateway (PG) guidelines from RBI, businesses cannot save their customers’ card numbers and other card data on their servers. Use the following endpoint to make payment using token id. /payments/create/redirect
Request

Step 3: Post Processing

If the payment is successful, you can query the razorpay_order_id in your database and mark the corresponding transaction at your end as paid.

Create Multiple Payments in a Batch

You can create bulk payments from the Dashboard. Know more about batch payments.