> ## Documentation Index > Fetch the complete documentation index at: https://razorpay-60c89f9a-mintlify-audit-missing-sections-1778528421.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 3. Create Subsequent Payments > You should perform the following steps to create and charge your customer subsequent payments: 1. [Create an order to charge the customer](#31-create-an-order-to-charge-the-customer) 2. [Create a recurring payment](#32-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. /orders ````cURL: 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", "notification":{ "token_id":"token_M7K2eFBU7vToaQ", "payment_after":1634057114 }, "notes": { "notes_key_1":"Tea, Earl Grey, Hot", "notes_key_2":"Tea, Earl Grey… decaf." } }' ```java: Java 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 notification = new JSONObject(); notification.put("token_id","token_M7K2eFBU7vToaQ"); notification.put("payment_after","1634057114"); orderRequest.put("notification", notification); 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 $api = new Api($key_id, $secret); $api->order->create(array( 'receipt' => '123', 'amount' => 100, 'payment_capture' => true, 'currency' => 'INR', 'notification' => array( 'token_id' => 'token_M7K2eFBU7vToaQ', 'payment_after' => '1634057114' ), 'notes' => array( 'key1' => 'value3', 'key2' => 'value2' ) )); ```javascript: Node.js 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", "notification": { "token_id":"token_M7K2eFBU7vToaQ", "payment_after":1634057114 }, "notes": { "notes_key_1":"Tea, Earl Grey, Hot", "notes_key_2":"Tea, Earl Grey… decaf." } }) ```python: Python client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET")) client.order.create({ 'amount': 1000, 'currency': 'INR', 'payment_capture': True, 'receipt': 'Receipt No. 1', 'notification': {'token_id': 'token_M7K2eFBU7vToaQ', 'payment_after': 1634057114}, 'notes': {'notes_key_1': 'Tea, Earl Grey, Hot', 'notes_key_2': 'Tea, Earl Grey... decaf.'} }) ```ruby: Ruby require "razorpay" Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET') para_attr = { "amount": 1000, "currency": "INR", "payment_capture": true, "receipt": "Receipt No. 1", "notification": { "token_id":"token_M7K2eFBU7vToaQ", "payment_after":1634057114 }, "notes": { "notes_key_1": "Tea, Earl Grey, Hot", "notes_key_2": "Tea, Earl Grey… decaf." } } Razorpay::Order.create(para_attr) ```go: Go 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", "notification": map[string]interface{}{ "token_id":"token_M7K2eFBU7vToaQ", "payment_after":1634057114 }, "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 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 notification = new Dictionary(); notification.Add("token_id", "token_M7K2eFBU7vToaQ"); notification.Add("payment_after", "1634057114"); orderRequest.Add("notification", notification); 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 { "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. For cards, the minimum value is `100` (1). `currency` *mandatory* : `string` The 3-letter ISO currency code for the payment. Currently, we only support `INR`. `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”`. `notification` : `object` Details of the pre-debit notification. This object is optional. You should use it only if you want to control pre-debit notifications and debits. If you do not pass this object, we will automatically try to debit 25 hours after the pre-debit notification is delivered. **Watch Out!** We will not attempt any retry if the debit fails for tokens with the notification object in the created order. You should manually retry the debit attempt. `token_id` *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`. `payment_after` *optional* : `integer` UNIX timestamp post which the debit is supposed to happen. Defaults to 25 hours after the pre-debit notification is delivered. `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](/api/payments#capture-a-payment). ## 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. /payments/create/recurring ````cURL: 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": "gaurav.kumar@example.com", "contact": "+919876543210", "amount": 1000, "currency": "INR", "order_id": "order_1Aa00000000002", "customer_id": "cust_1Aa00000000001", "token": "token_1Aa00000000001", "recurring": true, "description": "Creating recurring payment for Gaurav Kumar", "notes": { "note_key 1": "Beam me up Scotty", "note_key 2": "Tea. Earl Gray. Hot." } }' ```java: Java RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]"); JSONObject paymentRequest = new JSONObject(); paymentRequest.put("email", "gaurav.kumar@example.com"); paymentRequest.put("contact", "+919876543210"); 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 Gaurav Kumar"); 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 $api = new Api($key_id, $secret); $api->payment->createRecurring(array('email'=>'gaurav.kumar@example.com','contact'=>'+919876543210','amount'=>100,'currency'=>'INR','order_id'=>'order_1Aa00000000002','customer_id'=>'cust_1Aa00000000001','token'=>'token_1Aa00000000001','recurring'=>true,'description'=>'Creating recurring payment for Gaurav Kumar')); ```javascript: Node.js var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' }) instance.payments.createRecurringPayment({ "email": "gaurav.kumar@example.com", "contact": "+919876543210", "amount": 1000, "currency": "INR", "order_id": "order_1Aa00000000002", "customer_id": "cust_1Aa00000000001", "token": "token_1Aa00000000001", "recurring": true, "description": "Creating recurring payment for Gaurav Kumar", "notes": { "note_key 1": "Beam me up Scotty", "note_key 2": "Tea. Earl Gray. Hot." } }) ```python: Python client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET")) client.payment.createRecurring({ 'email': 'gaurav.kumar@example.com', 'contact': +919876543210, 'amount': 1000, 'currency': 'INR', 'order_id': "order_1Aa00000000002", 'customer_id': "cust_1Aa00000000001", 'token': 'token_1Aa00000000001', 'recurring': True, 'description': 'Creating recurring payment for Gaurav Kumar', 'notes': {'note_key 1': 'Beam me up Scotty', 'note_key 2': 'Tea. Earl Gray. Hot.'} }) ```ruby: Ruby require "razorpay" Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET') para_attr = { "email": "gaurav.kumar@example.com", "contact": "+919876543210", "amount": 1000, "currency": "INR", "order_id": "order_1Aa00000000002", "customer_id": "cust_1Aa00000000001", "token": "token_1Aa00000000001", "recurring": true, "description": "Creating recurring payment for Gaurav Kumar", "notes": { "note_key 1": "Beam me up Scotty", "note_key 2": "Tea. Earl Gray. Hot." } } Razorpay::Payment.create_recurring_payment(para_attr) ```go: Go import ( razorpay "github.com/razorpay/razorpay-go" ) client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET") data:= map[string]interface{}{ "email": "gaurav.kumar@example.com", "contact": "+919876543210", "amount": 1000, "currency": "INR", "order_id": "order_1Aa00000000002", "customer_id": "cust_1Aa00000000001", "token": "token_1Aa00000000001", "recurring": true, "description": "Creating recurring payment for Gaurav Kumar", "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 RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]"); Dictionary paymentRequest = new Dictionary(); paymentRequest.Add("email", "gaurav.kumar@example.com"); paymentRequest.Add("contact", "+919876543210"); 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 Gaurav Kumar"); 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 { "error":{ "code":"BAD_REQUEST_ERROR", "description":"Amount exceeds maximum amount allowed", "source":"business", "step":"payment_initiation", "reason":"input_validation_failed", "metadata":{ } } } ```` **UPI Payments** * We recommend sending a pre-debit notification to the customer 48 hours before the debit date. * For UPI, it may take between 24-36 hours for the subsequent payment to reflect on your Dashboard. * This is because of the failure of pre-debit notification and/or any retries that we attempt for the payment. * Do not create another subsequent payment until you get the status of the previous one. **UPI Payments** * The subsequent payment may fail if there is late authorisation of an earlier payment. * For UPI, **do not** create subsequent payments on the last day of the cycle. This will cause the payment to fail. ### 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. `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”`.