> ## 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 a One Time Payment > Create and charge a one time payment using Razorpay UPI Reserve Pay APIs.
Available in 🇮🇳 India
You should perform the following steps to create and charge your customer a one time payment: 1. [Create an order to charge the customer](#3-1-create-an-order-to-charge-the-customer) 2. [Create a one time payment](#3-2-create-a-one-time-payment) ## 3.1. Create an Order to Charge the Customer You have to create a new order to charge a one time mandate. This order is different from the one created during the authorisation transaction. **Watch Out!** We will not attempt any retry if the debit fails for tokens with the notification object in the created order. You must manually trigger the debit by calling the API, and only after the `payment_after` timestamp specified in the notification object. 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", "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 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 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 theme={null} $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 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", "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 theme={null} 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 theme={null} 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 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", "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 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 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 theme={null} { "error":{ "code":"BAD_REQUEST_ERROR", "description":"The id provided does not exist", "source":"business", "step":"payment_initiation", "reason":"input_validation_failed", "metadata":{ } } } ``` `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”`. `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. `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](/docs/api/payments/capture). ## 3.2. Create a One Time Payment Once you have generated an `order_id`, use it with the `token_id` to create a one-time payment. After the payment is complete (authorized or failed), the respective token will move to the `cancelled` state and you can no longer use the token. You will get the [token.cancelled](/docs/api/payments/recurring-payments/webhooks#token-cancelled) webhook notification for the same. The following endpoint creates a one time 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": "gaurav.kumar@example.com", "contact": "9000090000", "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 theme={null} RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]"); JSONObject paymentRequest = new JSONObject(); paymentRequest.put("email", "gaurav.kumar@example.com"); paymentRequest.put("contact", "9000090000"); 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 theme={null} $api = new Api($key_id, $secret); $api->payment->createRecurring(array('email'=>'gaurav.kumar@example.com','contact'=>'9000090000','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 theme={null} var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' }) instance.payments.createRecurringPayment({ "email": "gaurav.kumar@example.com", "contact": "9000090000", "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 theme={null} client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET")) client.payment.createRecurring({ 'email': 'gaurav.kumar@example.com', 'contact': 9000090000, '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 theme={null} require "razorpay" Razorpay.setup('YOUR_KEY_ID', 'YOUR_SECRET') para_attr = { "email": "gaurav.kumar@example.com", "contact": "9000090000", "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 theme={null} 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": "9000090000", "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 theme={null} RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]"); Dictionary paymentRequest = new Dictionary(); paymentRequest.Add("email", "gaurav.kumar@example.com"); paymentRequest.Add("contact", "9000090000"); 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", "razorpay_order_id": "order_1Aa00000000001", "razorpay_signature": "9398a4854983909b3df3f700e1a300f39bc48bbc1a125304cabd646fd6a006c6" } ``` ```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":{ } } } ``` `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`. `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”`.