> ## Documentation Index > Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 3. Create Subsequent Payments > Create and charge subsequent payments using Razorpay APIs after the customer's selected payment method is successfully authorised.
Available in 🇮🇳 India
You should perform the following steps to create and charge your customer subsequent payments: 1. [Create an order to charge the customer](#3-1-create-an-order-to-charge-the-customer) 2. [Create a recurring payment](#3-2-create-a-recurring-payment) ## 3.1. Create an Order to Charge the Customer You have to create a new order every time you want to charge your customers. This order is different from the one created during the authorisation transaction. The following endpoint creates an order. `POST /orders` ```bash Curl theme={null} curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \ -X POST https://api.razorpay.com/v1/orders \ -H "Content-Type: application/json" \ -d '{ "amount":1000, "currency":"INR", "payment_capture": true, "receipt":"Receipt No. 1", "notes": { "notes_key_1":"Tea, Earl Grey, Hot", "notes_key_2":"Tea, Earl Grey… decaf." } }' ``` ```java Java theme={null} RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]"); JSONObject orderRequest = new JSONObject(); orderRequest.put("amount", 1000); orderRequest.put("currency", "INR"); orderRequest.put("payment_capture", true); orderRequest.put("receipt", "Receipt No. 1"); JSONObject notes = new JSONObject(); notes.put("notes_key_1","Tea, Earl Grey, Hot"); notes.put("notes_key_2","Tea, Earl Grey… decaf."); orderRequest.put("notes", notes); Order order = razorpay.orders.create(orderRequest); ``` ```php PHP theme={null} $api = new Api($key_id, $secret); $api->order->create(array('receipt' => '123', 'amount' => 100, 'payment_capture' => true, 'currency' => 'INR', 'notes'=> array('key1'=> 'value3','key2'=> 'value2'))); ``` ```javascript Node.js theme={null} var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' }) instance.orders.create({ "amount":1000, "currency":"INR", "payment_capture": true, "receipt":"Receipt No. 1", "notes": { "notes_key_1":"Tea, Earl Grey, Hot", "notes_key_2":"Tea, Earl Grey… decaf." } }) ``` ```python Python theme={null} client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET")) client.order.create({ 'amount': 1000, 'currency': 'INR', 'payment_capture': True, 'receipt': 'Receipt No. 1', 'notes': {'notes_key_1': 'Tea, Earl Grey, Hot', 'notes_key_2': 'Tea, Earl Grey... decaf.'} }) ``` ```ruby Ruby theme={null} require "razorpay" Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET') para_attr = { "amount": 1000, "currency": "INR", "payment_capture": true, "receipt": "Receipt No. 1", "notes": { "notes_key_1": "Tea, Earl Grey, Hot", "notes_key_2": "Tea, Earl Grey… decaf." } } Razorpay::Order.create(para_attr) ``` ```go Go theme={null} import ( razorpay "github.com/razorpay/razorpay-go" ) client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_S ECRET") data:= map[string]interface{}{ "amount":1000, "currency":"INR", "payment_capture": true, "receipt":"Receipt No. 1", "notes": map[string]interface{}{ "notes_key_1":"Tea, Earl Grey, Hot", "notes_key_2":"Tea, Earl Grey… decaf.", }, } body, err := client.Order.Create(data, nil) ``` ```csharp .NET theme={null} RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]"); Dictionary orderRequest = new Dictionary(); orderRequest.Add("amount", 100); orderRequest.Add("currency", "INR"); orderRequest.Add("receipt", "receipt#12b"); orderRequest.Add("payment_capture", true); Dictionary notes = new Dictionary(); notes.Add("notes_key_1", "Tea, Earl Grey, Hot"); notes.Add("notes_key_2", "Tea, Earl Grey… decaf."); orderRequest.Add("notes", notes); Order order = client.Order.Create(orderRequest); ``` ```json Success Response theme={null} { "id":"order_1Aa00000000002", "entity":"order", "amount":1000, "amount_paid":0, "amount_due":1000, "currency":"INR", "receipt":"Receipt No. 1", "offer_id":null, "status":"created", "attempts":0, "notes":{ "notes_key_1":"Tea, Earl Grey, Hot", "notes_key_2":"Tea, Earl Grey… decaf." }, "created_at":1579782776 } ``` ```json Failure Response theme={null} { "error":{ "code":"BAD_REQUEST_ERROR", "description":"The id provided does not exist", "source":"business", "step":"payment_initiation", "reason":"input_validation_failed", "metadata":{ } } } ``` ### Request Parameters `amount` *mandatory* : `integer` Amount in currency subunits. `currency` *mandatory* : `string` The 3-letter ISO currency code for the payment. `receipt` *optional* : `string` A user-entered unique identifier for the order. For example, `Receipt No. 1`. You should map this parameter to the `order_id` sent by Razorpay. `notes` *optional* : `object` Key-value pair you can use to store additional information about the entity. Maximum of 15 key-value pairs, 256 characters each. For example, `"note_key": "Beam me up Scotty”`. `payment_capture` *mandatory* : `boolean` Determines whether the payment status should be changed to `captured` automatically or not. Possible values: * `true`: Payments are captured automatically. * `false`: Payments are not captured automatically. You can manually capture payments using the [Manually Capture Payments API](/docs/api/payments/capture). ### Response Parameters `id` : `string` A unique identifier of the order created. For example `order_1Aa00000000001`. `entity` : `string` The entity that has been created. Here it is `order`. `amount` : `integer` Amount in currency subunits. `amount_paid` : `integer` The amount that has been paid. `amount_due` : `integer` The amount that is yet to pay. `currency` : `string` The 3-letter ISO currency code for the payment. Currently, we only support `INR`. `receipt` : `string` A user-entered unique identifier of the order. For example, `rcptid #1`. `status` : `string` The status of the order. `notes` : `object` Key-value pair you can use to store additional information about the entity. Maximum of 15 key-value pairs, 256 characters each. For example, `"note_key": "Beam me up Scotty”`. `created_at` : `integer` The Unix timestamp at which the order was created. ### Error Response Parameters Given below is a list of possible errors you may face while creating an Order. | Error | Cause | Solution | | --------------------------------------------- | ------------------------------------------------------------- | ------------------------------------------------ | | The api key provided is invalid | This error occurs when you enter the wrong API key or secret. | Make sure to enter the valid API key and secret. | | The amount must be at least INR 1.00. | This error occurs when you enter an amount less than INR 1. | Make sure the entered amount is atleast INR 1. | | The currency should be INR when method is upi | This error occurs when you enter a currency other than INR. | Make sure the currency is INR. | ## 3.2. Create a Recurring Payment Once you have generated an `order_id`, use it with the `token_id` to create a payment and charge the customer. The following endpoint creates a payment to charge the customer. `POST /payments/create/recurring` ```bash Curl theme={null} curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \ -X POST https://api.razorpay.com/v1/payments/create/recurring \ -H "Content-Type: application/json" \ -d '{ "email": "", "contact": "", "amount": 1000, "currency": "INR", "order_id": "order_1Aa00000000002", "customer_id": "cust_1Aa00000000001", "token": "token_1Aa00000000001", "recurring": true, "description": "Creating recurring payment for ", "notes": { "note_key 1": "Beam me up Scotty", "note_key 2": "Tea. Earl Gray. Hot." } }' ``` ```java Java theme={null} RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]"); JSONObject paymentRequest = new JSONObject(); paymentRequest.put("email", ""); paymentRequest.put("contact", ""); paymentRequest.put("amount", 1000); paymentRequest.put("currency", "INR"); paymentRequest.put("order_id", "order_1Aa00000000002"); paymentRequest.put("customer_id", "cust_1Aa00000000001"); paymentRequest.put("token", "token_1Aa00000000001"); paymentRequest.put("recurring", true); paymentRequest.put("description", "Creating recurring payment for "); JSONObject notes = new JSONObject(); paymentRequest.put("notes_key_1","Tea, Earl Grey, Hot"); paymentRequest.put("notes_key_2","Tea, Earl Grey… decaf."); Payment payment = razorpay.payments.createRecurringPayment(paymentRequest); ``` ```php PHP theme={null} $api = new Api($key_id, $secret); $api->payment->createRecurring(array('email'=>'','contact'=>'','amount'=>100,'currency'=>'INR','order_id'=>'order_1Aa00000000002','customer_id'=>'cust_1Aa00000000001','token'=>'token_1Aa00000000001','recurring'=>true,'description'=>'Creating recurring payment for ')); ``` ```javascript Node.js theme={null} var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' }) instance.payments.createRecurringPayment({ "email": "", "contact": "", "amount": 1000, "currency": "INR", "order_id": "order_1Aa00000000002", "customer_id": "cust_1Aa00000000001", "token": "token_1Aa00000000001", "recurring": true, "description": "Creating recurring payment for ", "notes": { "note_key 1": "Beam me up Scotty", "note_key 2": "Tea. Earl Gray. Hot." } }) ``` ```python Python theme={null} client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET")) client.payment.createRecurring({ 'email': '', 'contact': , 'amount': 1000, 'currency': 'INR', 'order_id': "order_1Aa00000000002", 'customer_id': "cust_1Aa00000000001", 'token': 'token_1Aa00000000001', 'recurring': True, 'description': 'Creating recurring payment for ', 'notes': {'note_key 1': 'Beam me up Scotty', 'note_key 2': 'Tea. Earl Gray. Hot.'} }) ``` ```ruby Ruby theme={null} require "razorpay" Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET') para_attr = { "email": "", "contact": "", "amount": 1000, "currency": "INR", "order_id": "order_1Aa00000000002", "customer_id": "cust_1Aa00000000001", "token": "token_1Aa00000000001", "recurring": true, "description": "Creating recurring payment for ", "notes": { "note_key 1": "Beam me up Scotty", "note_key 2": "Tea. Earl Gray. Hot." } } Razorpay::Payment.create_recurring_payment(para_attr) ``` ```go Go theme={null} import ( razorpay "github.com/razorpay/razorpay-go" ) client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET") data:= map[string]interface{}{ "email": "", "contact": "", "amount": 1000, "currency": "INR", "order_id": "order_1Aa00000000002", "customer_id": "cust_1Aa00000000001", "token": "token_1Aa00000000001", "recurring": true, "description": "Creating recurring payment for ", "notes": map[string]interface{}{ "note_key 1": "Beam me up Scotty", "note_key 2": "Tea. Earl Gray. Hot.", }, } body, err := Client.Payment.CreateRecurringPayment(data, nil) ``` ```csharp .NET theme={null} RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]"); Dictionary paymentRequest = new Dictionary(); paymentRequest.Add("email", ""); paymentRequest.Add("contact", ""); paymentRequest.Add("amount", 1000); paymentRequest.Add("currency", "INR"); paymentRequest.Add("order_id", "order_MZ35KPxZaqxfXq"); paymentRequest.Add("customer_id", "cust_KUyah9o60OPhfj"); paymentRequest.Add("token", "token_MZ37MsnhLNH4tN"); paymentRequest.Add("recurring", true); paymentRequest.Add("description", "Creating recurring payment for "); Dictionary notes = new Dictionary(); notes.Add("notes_key_1", "Tea, Earl Grey, Hot"); notes.Add("notes_key_2", "Tea, Earl Grey… decaf."); paymentRequest.Add("notes", notes); Payment payment = client.Payment.CreateRecurringPayment(paymentRequest); ``` ```json Success Response theme={null} { "razorpay_payment_id" : "pay_1Aa00000000001" } ``` ```json Failure Response theme={null} { "error":{ "code":"BAD_REQUEST_ERROR", "description":"Amount exceeds maximum amount allowed", "source":"business", "step":"payment_initiation", "reason":"input_validation_failed", "metadata":{ } } } ``` ### Request Parameters `email ` *mandatory* : `string` The customer's email address. For example, `gaurav.kumar@example.com`. `contact ` *mandatory* : `integer` The customer's phone number. For example, `9876543210`. `currency` *mandatory* : `string` 3-letter ISO currency code for the payment. Currently, only `INR` is allowed. `amount` *mandatory* : `integer` The amount you want to charge your customer. This should be the same as the order amount. `order_id`*mandatory* : `string` The unique identifier of the order created. For example, `order_1Aa00000000002`. `customer_id` *mandatory* : `string` The unique identifier of the customer you want to charge. For example, `cust_1Aa00000000002`. `token` *mandatory* : `string` The `token_id` generated when the customer successfully completes the authorisation payment. Different payment instruments for the same customer have different `token_id`. `recurring` *mandatory* : `boolean` Determines whether recurring payment is enabled or not. * `true`: Recurring payment is enabled. * `false`: Recurring payment is not enabled. `description`*optional* : `string` A user-entered description for the payment. For example, `Creating recurring payment for Gaurav Kumar` `notes`*optional* : `object` Key-value pair you can use to store additional information about the entity. Maximum of 15 key-value pairs, 256 characters each. For example, `"note_key": "Beam me up Scotty”`. ### Response Parameters `razorpay_payment_id` : `string` The unique identifier of the payment that is created. For example, `pay_1Aa00000000001`. `razorpay_order_id` : `string` The unique identifier of the order that is created. For example, `order_1Aa00000000001`. `razorpay_signature` : `string` The signature generated by the Razorpay. For example, `9ef4dffbfd84f1318f6739a3ce19f9d85851857ae648f114332d8401e0949a3d`. ### Error Response Parameters Given below is a list of possible errors you may face while creating a Recurring Payment. | Error | Cause | Solution | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | bank\_account\_invalid | This error occurs when The customer's bank account is either closed or no longer valid. The customer or bank may have closed the account. | The customer should re-register the mandate. | | bank\_account\_validation\_failed | This error occurs when the bank could not validate the customer registration for debiting the customer. | You can retry after some time or reach out to Razorpay. | | bank\_technical\_error | The destination bank was facing technical problems at the time the payment was attempted. This error usually occurs when the Core Banking System encounters a technical error while processing the payment. | You can retry after some time or reach out to Razorpay. | | debit\_instrument\_blocked | This error occurs when the bank temporarily blocks withdrawals on the customer's account. | The customer should reach out to their bank to get the account unblocked. | | debit\_instrument\_inactive | This error occurs when the bank temporarily blocks withdrawals on the customer's account. | The customer should reach out to their bank to get the account unblocked. | | gateway\_technical\_error | The payment failed due to a technical error at the gateway. This error usually occurs when the gateway server encounters a technical error while processing the payment. | You can retry after some time or reach out to Razorpay. | | incorrect\_ifsc | This error occurs when the bank IFSC code is no longer valid. | The customer should re-register the mandate. | | input\_validation\_failed | The payment failed due to the wrong request or input sent in the payment request. You can also get this error while creating a payment with incorrect parameter values on the Dashboard. | Rectify the validation issues and try again. Check the error description and field parameters for more information about the error. Check your integration/payment request or reach out to Razorpay. Refer to the [API Reference Guide](/docs/api). | | insufficient\_funds | This error occurs when the customer does not have sufficient funds in the account to complete the payment. | You can retry after asking the customer to add funds to their bank account. | | invalid\_amount | This error occurs when the amount or currency passed in the payment request is not supported or invalid. This can arise when you pass a different variable type in the amount field or pass an unsupported amount value. | You can check your integration and payment request. | | mandate\_not\_active | This error occurs when the registered mandate is no longer active. The customer or bank could have cancelled the mandate. | The customer should re-register the mandate. | | payment\_cancelled | This error occurs when the customer has explicitly cancelled the payment. The customer could have given a cancellation instruction to their banks. | You can retry after informing the customer to remove the cancellation request. | | payment\_declined | Destination Bank or Gateway has declined the payment due to business or technical reasons such as terminal and pricing. | You can retry after some time or reach out to Razorpay. | | payment\_failed | This error occurs when the destination Bank or Gateway has declined the payment due to business or technical reasons such as terminal and pricing. | You can retry after some time or reach out to Razorpay. | | payment\_mandate\_not\_active | This error occurs when the is not yet activated the registered mandate. Banks sometimes take longer to activate the mandates at their end. | You can retry after some time or reach out to Razorpay. | | payment\_timed\_out | This error occurs when the bank with the registered mandate could not debit the customer's account in time. | You can retry after some time or reach out to Razorpay. | | server\_error | This error occurs when there is a technical error at Razorpay's server. | You can retry after some time or reach out to Razorpay. | | transaction\_limit\_exceeded | This error occurs when customers exceed their account's credit or debit limit during high-value transactions. | You can retry after some time by informing the customer to update their transaction limits. |