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 therazorpay_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.
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 theorder_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/redirectRequest
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/redirectRequest
Step 3: Post Processing
If the payment is successful, you can query therazorpay_order_id in your database and mark the corresponding transaction at your end as paid.