{"openapi":"3.0.0","info":{"description":"Payment gateway","version":[{"name":"v1","value":"v1"}]},"servers":[{"description":"Payment gateway","url":"https://api.apirails.com/razorpay"}],"paths":{"/v1/customers":{"post":{"tags":["Customers"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/customers#create-a-customer","api_endpoint":"https://api.razorpay.com/v1/customers"},"summary":"Create a Customer","description":"Create a Customer","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"contact":{"type":"string","description":"The customer's phone number. A maximum length of 15 characters including country code. For example; +919876543210."},"email":{"type":"string","description":"The customer's email address. A maximum length of 64 characters. For example; gaurav.kumar@example.com."},"fail_existing":{"type":"string","description":"Possible values-0; If a customer with the same details already exist; fetches details of the existing customer.1 (default)- If a customer with the same details already exists; throws an error."},"gstin":{"type":"string","description":"Customer's GST number; if available. For example; 29XAbbA4369J1PA."},"name":{"type":"sting","description":"Customer's name. Alphanumeric value with period (.); apostrophe (') and parentheses are allowed. The name must be between 3-50 characters in length. For example; Gaurav Kumar.","required":true},"notes":{"type":"object","description":"This is a key-value pair that can be used to store additional information about the entity. It can hold a maximum of 15 key-value pairs; 256 characters (maximum) each. For example; \"note_key\"","enum":["\"Beam me up Scotty”."],"properties":{"key":{"type":"string","description":"Arbitrary key name. Maximum 15 key-value pairs, 256 characters each."},"value":{"type":"string","description":"Value for the key. Maximum 256 characters."}}}}},"example":{"contact":"","email":"","fail_existing":"","gstin":"","name":"","notes":{}}}}}},"get":{"tags":["Customers"],"parameters":[{"name":"count","in":"query","description":"The number of customer records to be retrieved from the system. The default value is 10. The maximum value is 100. This can be used for pagination in combination with skip.","schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"The number of customer records that must be skipped. The default value is 0. This can be used for pagination in combination with count.","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/customers#fetch-all-customers","api_endpoint":"https://api.razorpay.com/v1/customers"},"summary":"Fetch all Customers","description":"Fetch all Customers","security":[{"bearerAuth":[]}]}},"/v1/customers/{cust_id}":{"get":{"tags":["Customers"],"parameters":[{"name":"cust_id","in":"path","description":"The unique identifier linked to the customer.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/customers#fetch-customer-by-id","api_endpoint":"https://api.razorpay.com/v1/customers/:cust_id"},"summary":"Fetch Customer by ID","description":"Fetch Customer by ID","security":[{"bearerAuth":[]}]},"put":{"tags":["Customers"],"parameters":[{"name":"cust_id","in":"path","description":"The unique identifier linked to the customer.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/customers#edit-customer-details","api_endpoint":"https://api.razorpay.com/v1/customers/:cust_id"},"summary":"Edit a Customer","description":"Edit a Customer","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"The customer's email address. A maximum length of 64 characters. For example; gaurav.kumar@example.com."},"name":{"type":"string","description":"Customer's name. Alphanumeric; with period (.); apostrophe (') and parentheses allowed. The name must be between 3-50 characters in length. For example; Gaurav Kumar..\ncontact","enum":["string"]}}},"example":{"email":"","name":""}}}}}},"/v1/disputes":{"get":{"tags":["Disputes"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/disputes#fetch-all-disputes","api_endpoint":"https://api.razorpay.com/v1/disputes"},"summary":"Fetch All Disputes","description":"Fetch All Disputes","security":[{"bearerAuth":[]}]}},"/v1/disputes/{id}":{"get":{"tags":["Disputes"],"parameters":[{"name":"id","in":"path","description":"The unique identifier of the dispute.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/disputes#fetch-a-dispute","api_endpoint":"https://api.razorpay.com/v1/disputes/id"},"summary":"Fetch a Dispute by ID","description":"Fetch a Dispute by ID","security":[{"bearerAuth":[]}]}},"/v1/invoices":{"post":{"tags":["Invoice"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/invoices#create-an-invoice","api_endpoint":"https://api.razorpay.com/v1/invoices"},"summary":"Create an Invoice","description":"Create an Invoice","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"type":{"type":"string","description":"Indicates the type of entity. Here; it is invoice.","required":true},"currency":{"type":"string","description":"The currency associated with the invoice. You must mandatorily pass this parameter if accepting international payments. If you have passed currency as a sub-parameter in the line_item object; you must ensure that the same currency is passed in both places. Know about the list of supported international currencies."},"customer_id":{"type":"string","description":"You can pass the customer_id in this field; if you are using theCustomers API. If not; you can pass the customer object described in the below fields."},"description":{"type":"string","description":"A brief description of the invoice."},"draft":{"type":"string","description":"Invoice is created in draft state when value is set to 1."},"email_notify":{"type":"boolean","description":"Defines who handles the email notification. Possible values-0- You send the notification to the customer.1 (default)- Razorpay sends the notification to the customer.","enum":[true,false]},"expire_by":{"type":"number","description":"Timestamp; in Unix format; at which the invoice will expire."},"partial_payment":{"type":"boolean","description":"Indicates whether the customer can make a partial payment on the invoice. Possible values- true- The customer can make partial payments.false (default)- The customer cannot make partial payments.","enum":[true,false]},"sms_notify":{"type":"boolean","description":"Defines who handles the SMS notification. Possible values- 0- You send the notification to the customer.1 (default)- Razorpay sends the notification to the customer.","enum":[true,false]}}},"example":{"type":"","currency":"","customer_id":"","description":"","draft":"","email_notify":"","expire_by":"","partial_payment":"","sms_notify":""}}}}},"get":{"tags":["Subscriptions"],"parameters":[{"name":"subscription_id","in":"query","description":"The unique identifier linked to the Subscription. For example; sub_00000000000001","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#fetch-all-invoices-of-a-subscription","api_endpoint":"https://api.razorpay.com/v1/invoices"},"summary":"Fetch All Invoices for a Subscription","description":"Fetch All Invoices for a Subscription","security":[{"bearerAuth":[]}]}},"/v1/invoices/{inv_id}":{"get":{"tags":["Invoice"],"parameters":[{"name":"inv_id","in":"path","description":"The unique identifier of the invoice whose details are to be viewed.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/invoices#fetch-an-invoice","api_endpoint":"https://api.razorpay.com/v1/invoices/:inv_id"},"summary":"Fetch Invoice by Id","description":"Fetch Invoice by Id","security":[{"bearerAuth":[]}]},"patch":{"tags":["Invoice"],"parameters":[{"name":"inv_id","in":"path","description":"The unique identifier of the invoice whose details are to be updated.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/invoices#update-an-invoice","api_endpoint":"https://api.razorpay.com/v1/invoices/:inv_id"},"summary":"Update an Invoice","description":"Update an Invoice","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"delete":{"tags":["Invoice"],"parameters":[{"name":"inv_id","in":"path","description":"Unique identifier of the invoice that you want to delete.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/invoices#delete-an-invoice","api_endpoint":"https://api.razorpay.com/v1/invoices/:inv_id"},"summary":"Delete an Invoice","description":"Delete an Invoice","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/invoices/{inv_id}/issue":{"post":{"tags":["Invoice"],"parameters":[{"name":"inv_id","in":"path","description":"The unique identifier of the invoice that needs to be issued.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/invoices#issue-an-invoice","api_endpoint":"https://api.razorpay.com/v1/invoices/:inv_id/issue"},"summary":"Issue an Invoice","description":"Issue an Invoice","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/invoices/{inv_id}/notify_by/{medium}":{"post":{"tags":["Invoice"],"parameters":[{"name":"inv_id","in":"path","description":"The unique identifier of the invoice whose link is to be sent by SMS or email.","required":true,"schema":{"type":"string","example":""}},{"name":"medium","in":"path","description":"Possible values- sms;email","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/invoices#send-notifications","api_endpoint":"https://api.razorpay.com/v1/invoices/:inv_id/notify_by/:medium"},"summary":"Send or Resend Notification","description":"Send or Resend Notification","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"sucess":{"type":"boolean","description":"Indicates whether the notifications were sent successfully. Possible values-true- The notifications were successfully via SMS; email or both. false- The notifications were not sent.","enum":[true,false]}}},"example":{"sucess":""}}}}}},"/v1/invoices/{inv_id}/cancel":{"post":{"tags":["Invoice"],"parameters":[{"name":"inv_id","in":"path","description":"The unique identifier of the invoice that needs to be cancelled.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/invoices#cancel-an-invoice","api_endpoint":"https://api.razorpay.com/v1/invoices/:inv_id/cancel"},"summary":"Cancel an Invoice","description":"Cancel an Invoice","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/items":{"post":{"tags":["Items"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/items#create-an-item","api_endpoint":"https://api.razorpay.com/v1/items"},"summary":"Create an Item","description":"Create an Item","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"amount":{"type":"integer","description":"The price of the item.","required":true},"currency":{"type":"string","description":"The currency in which the amount should be charged. Check the list of supported currencies.","required":true},"description":{"type":"string","description":"A brief description about the item."},"name":{"type":"string","description":"Name of the item.","required":true}}},"example":{"amount":"","currency":"","description":"","name":""}}}}},"get":{"tags":["Items"],"parameters":[{"name":"active","in":"query","description":"Fetches number of active or inactive items. The value is 1 for active items.The value is 0 for inactive items.","schema":{"type":"number","example":""}},{"name":"count","in":"query","description":"Number of items to be fetched.Default value- 10;Maximum value- 100.This can be used for pagination; in combination with the skip parameter.","schema":{"type":"number","example":""}},{"name":"form","in":"query","description":"Unix timestamp; in seconds; from when the items are to be fetched.","schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of records to be skipped while fetching the items.","schema":{"type":"number","example":""}},{"name":"to","in":"query","description":"Unix timestamp; in seconds; till when the items are to be fetched.","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/items#fetch-multiple-items","api_endpoint":"https://api.razorpay.com/v1/items"},"summary":"Fetch Items","description":"Fetch Items","security":[{"bearerAuth":[]}]}},"/v1/items/{item_id}":{"get":{"tags":["Items"],"parameters":[{"name":"item_id","in":"path","description":"The unique identifier of the item whose details are to be fetched.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/items#fetch-an-item","api_endpoint":"https://api.razorpay.com/v1/items/:item_id"},"summary":"Fetch Item by ID","description":"Fetch Item by ID","security":[{"bearerAuth":[]}]},"patch":{"tags":["Items"],"parameters":[{"name":"item_id","in":"path","description":"The unique identifer of the item whose details are to be updated.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/items#update-an-item","api_endpoint":"https://api.razorpay.com/v1/items/:item_id"},"summary":"Update an Item","description":"Update an Item","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"active":{"type":"boolean","description":"Indicates the status of the item. Possible values- true (default)- Item is in the active state. false- Item is in the inactive state.","enum":[true,false]},"amount":{"type":"number","description":"The price of the item in the lowest unit of currency."},"currency":{"type":"string","description":"The currency in which the amount should be charged. Check the list of supported currencies"},"description":{"type":"string","description":"A brief description about the item."},"name":{"type":"string","description":"The name of the item."}}},"example":{"active":"","amount":"","currency":"","description":"","name":""}}}}},"delete":{"tags":["Items"],"parameters":[{"name":"item_id","in":"path","description":"The unique identifier of the item that must be deleted.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/items#delete-an-item","api_endpoint":"https://api.razorpay.com/v1/items/:item_id"},"summary":"Delete an Item","description":"Delete an Item","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/orders":{"post":{"tags":["Order"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/orders#create-an-order","api_endpoint":"https://api.razorpay.com/v1/orders"},"summary":"Create an Order","description":"Create an Order","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"amount":{"type":"number","description":"The amount for which the order was created; in currency subunits. For example; for an amount of ₹295; enter 29500. Payment can only be made for this amount against the Order.","required":true},"currency":{"type":"string","description":"ISO code for the currency in which you want to accept the payment. The default length is 3 characters. Refer to the list of supported currencies.","required":true},"first_payment_min_amount":{"type":"number","description":"Minimum amount that must be paid by the customer as the first partial payment. For example; if an amount of ₹7000 is to be received from the customer in two installments of #1 - ₹5000; #2 - ₹2000; then you can set this value as 500000. This parameter should be passed only if partial_payment is true."},"notes":{"type":"object","description":"Key-value pair that can be used to store additional information about the entity. Maximum 15 key-value pairs; 256 characters (maximum) each.","properties":{"key":{"type":"string","description":"Arbitrary key name. Maximum 15 key-value pairs, 256 characters each."},"value":{"type":"string","description":"Value for the key. Maximum 256 characters."}}},"partial_payment":{"type":"boolean","description":"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.","enum":[true,false]},"receipt":{"type":"string","description":"Receipt number that corresponds to this order; set for your internal reference. Can have a maximum length of 40 characters and has to be unique."}}},"example":{"amount":"","currency":"","first_payment_min_amount":"","notes":{},"partial_payment":"","receipt":""}}}}},"get":{"tags":["Order"],"parameters":[{"name":"authorized","in":"query","description":"Possible values 1/0","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"count","in":"query","description":"The number of orders to be fetched. The default value is 10. The maximum value is 100.This can be used for pagination; in combination with skip.","schema":{"type":"number","example":""}},{"name":"expand[]","in":"query","description":"Used to retrieve additional information about the payment. Using this parameter will cause a sub-entity to be added to the response.","schema":{"type":"array","example":""}},{"name":"form","in":"query","description":"Timestamp (in Unix format) from when the orders should be fetched.","schema":{"type":"number","example":""}},{"name":"receipt","in":"query","description":"Retrieves the orders that contain the provided value for receipt.","schema":{"type":"string","example":""}},{"name":"skip","in":"query","description":"The number of orders to be skipped. The default value is 0. This can be used for pagination; in combination with count.","schema":{"type":"number","example":""}},{"name":"to","in":"query","description":"Timestamp (in Unix format) up till when orders are to be fetched.","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/orders#fetch-orders","api_endpoint":"https://api.razorpay.com/v1/orders"},"summary":"Fetch Orders","description":"Fetch Orders","security":[{"bearerAuth":[]}]}},"/v1/orders/{order_id}":{"get":{"tags":["Order"],"parameters":[{"name":"order_id","in":"path","description":"Unique identifier of the order to be retrieved.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/orders#fetch-an-order-with-id","api_endpoint":"https://api.razorpay.com/v1/orders/:order_id"},"summary":"Fetch Orders by ID","description":"Fetch Orders by ID","security":[{"bearerAuth":[]}]},"patch":{"tags":["Order"],"parameters":[{"name":"order_id","in":"path","description":"Unique identifier of the order in which the Notes field must be updated.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/orders#update-order","api_endpoint":"https://api.razorpay.com/v1/orders/:order_id"},"summary":"Update Order","description":"Update Order","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"notes":{"type":"object","description":"Key-value pair that can be used to store additional information about the entity. Maximum 15 key-value pairs; 256 characters (maximum) each.","required":true,"properties":{"key":{"type":"string","description":"Arbitrary key name. Maximum 15 key-value pairs, 256 characters each."},"value":{"type":"string","description":"Value for the key. Maximum 256 characters."}}}}},"example":{"notes":{}}}}}}},"/v1/orders/{order_id}/payments":{"get":{"tags":["Payments"],"parameters":[{"name":"order_id","in":"path","description":"Unique identifier of the order for which you want to fetch payment details.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments#fetch-payments-based-on-orders","api_endpoint":"https://api.razorpay.com/v1/orders/:order_id/payments"},"summary":"Fetch Payment based on Order","description":"Fetch Payment based on Order","security":[{"bearerAuth":[]}]}},"/v1/payment_links/{plink_id}":{"patch":{"tags":["Payment Links"],"parameters":[{"name":"plink_id","in":"path","description":"The unique identifier of the Payment Link that needs to be updated.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/payment-links#update-payment-link","api_endpoint":"https://api.razorpay.com/v1/payment_links/:plink_id"},"summary":"Update a Payment Link","description":"Update a Payment Link","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"accept_partial":{"type":"boolean","description":"Indicates whether customers can make partial payments using the Payment Link. Possible values-true- Customer can make partial payments.false (default)- Customer cannot make partial payments","enum":[true,false]},"expire_by":{"type":"number","description":"Timestame; in Unix format; when the payment links should expire"},"notes":{"type":"object","description":"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”.","properties":{"key":{"type":"string","description":"Arbitrary key name. Maximum 15 key-value pairs, 256 characters each."},"value":{"type":"string","description":"Value for the key. Maximum 256 characters."}}},"reference_id":{"type":"string","description":"Adds a unique reference number to an existing link"}}},"example":{"accept_partial":"","expire_by":"","notes":{},"reference_id":""}}}}},"get":{"tags":["Payment Links"],"parameters":[{"name":"plink_id","in":"path","description":"Unique identifier of the Payment Link.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/payment-links#fetch-specific-payment-links-by-id","api_endpoint":"https://api.razorpay.com/v1/payment_links/:plink_id"},"summary":"Fetch a Payment Link","description":"Fetch a Payment Link","security":[{"bearerAuth":[]}]}},"/v1/payment_links/{plink_id}/cancel":{"post":{"tags":["Payment Links"],"parameters":[{"name":"plink_id","in":"path","description":"Unique identifier of the Payment Link","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/payment-links#cancel-payment-link","api_endpoint":"https://api.razorpay.com/v1/payment_links/:plink_id/cancel"},"summary":"Cancel a Payment Link","description":"Cancel a Payment Link","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/payment_links":{"get":{"tags":["Payment Links"],"parameters":[{"name":"payment_id","in":"query","description":"Unique identifier of the payment associated with the Payment Link","schema":{"type":"string","example":""}},{"name":"reference_id","in":"query","description":"The unique reference number entered by you while creating the Payment Link","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/payment-links#fetch-all-payment-links","api_endpoint":"https://api.razorpay.com/v1/payment_links"},"summary":"Fetch all Payment Links","description":"Fetch all Payment Links","security":[{"bearerAuth":[]}]},"post":{"tags":["Payment Links"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/payment-links/#create-payment-link","api_endpoint":"https://api.razorpay.com/v1/payment_links"},"summary":"Create a Payment Link","description":"Create a Payment Link","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"accept_partial":{"type":"boolean","description":"Indicates whether customers can make partial payments using the Payment Link. Possible values- true- Customer can make partial payments.false (default)- Customer cannot make partial payments.","enum":[true,false]},"amount":{"type":"number","description":"Amount to be paid using the Payment Link. Must be in the smallest unit of the currency. For example- if you want to receive a payment of ₹300.00; you must enter the value 30000.","required":true},"callback_method":{"type":"string","description":"If callback_url parameter is passed; callback_method must be passed with the value get.","required":true},"callback_url":{"type":"string","description":"If specified; adds a redirect URL to the Payment Link. Once customers completes the payment; they are redirected to the specified URL"},"currency":{"type":"string","description":"A three-letter ISO code for the currency in which you want to accept the payment. For example; INR."},"customer":{"type":"object","description":"Customer details","properties":{"name":{"type":"string","description":"The customer's name. Alphanumeric value with period (.), apostrophe (') and parentheses are allowed."},"email":{"type":"string","description":"The customer's email address."},"contact":{"type":"string","description":"The customer's phone number. A maximum of 15 characters including country code."}}},"description":{"type":"string","description":"A brief description of the Payment Link. The maximum character limit supported is 2048"},"expire_by":{"type":"number","description":"Timestamp; in Unix; at which the Payment Link will expire. By default; a Payment Link will be valid for six months from the date of creation. Please note that the expire by date cannot exceed more than six months from the date of creation"},"first_min_partial_amount":{"type":"number","description":"Minimum amount; in currency subunits; that must be paid by the customer as the first partial payment. Default value is 100. Default currency is INR. For example- if an amount of ₹700.00 is to be received from the customer in two installments of #1 - ₹500.00; #2 - ₹200.00; then you can set this value as 500000. Must be passed along with accept_partial parameter.","required":true},"notes":{"type":"object","description":"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”.","properties":{"key":{"type":"string","description":"Arbitrary key name. Maximum 15 key-value pairs, 256 characters each."},"value":{"type":"string","description":"Value for the key. Maximum 256 characters."}}},"notify":{"type":"object","description":"Defines who handles Payment Link notification.","properties":{"sms":{"type":"boolean","description":"Defines who handles the SMS notification. true - Razorpay handles. false - You handle."},"email":{"type":"boolean","description":"Defines who handles the email notification. true - Razorpay handles. false - You handle."}}},"reference_id":{"type":"string","description":"Reference number tagged to a Payment Link. Must be a unique number for each Payment Link. The maximum character limit supported is 40"},"reminder_enable":{"type":"boolean","description":"Used to send reminders for the Payment Link. Possible values- true- To send reminders.false- To disable reminders.","enum":[true,false]},"upi_link":{"type":"boolean","description":"Must be set to true for creating UPI Payment Link","required":true,"enum":[true,false]}}},"example":{"accept_partial":"","amount":"","callback_method":"","callback_url":"","currency":"","customer":{},"description":"","expire_by":"","first_min_partial_amount":"","notes":{},"notify":{},"reference_id":"","reminder_enable":"","upi_link":""}}}}}},"/v1/payment_links/{plink_id}/notify_by/{medium}":{"post":{"tags":["Payment Links"],"parameters":[{"name":"medium","in":"path","description":"Medium through which the Payment Link must be resent. Possible values-sms/email","required":true,"schema":{"type":"string","example":""}},{"name":"plink_id","in":"path","description":"Unique identifier of the Payment Link that should be resent","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/payment-links#send-or-resend-notifications","api_endpoint":"https://api.razorpay.com/v1/payment_links/:plink_id/notify_by/:medium"},"summary":"Resend a Payment Link","description":"Resend a Payment Link","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/payments":{"get":{"tags":["Payments"],"parameters":[{"name":"count","in":"query","description":"Number of payments to be fetched.Default value is 10. Maximum value is 100. This can be used for pagination; in combination with the skip parameter.","schema":{"type":"number","example":""}},{"name":"expend[]","in":"query","description":"Used to retrieve additional information about the payment; the method used to make the payment. The response will include a sub-entity if this parameter is used.\nPossible values-card- Expanded card details; usable for card and EMI payments.emi- Expanded EMI plan details; usable for EMI payments.","schema":{"type":"array","example":""}},{"name":"form","in":"query","description":"UNIX timestamp; in seconds; from when payments are to be fetched.","schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of records to be skipped while fetching the payments.","schema":{"type":"number","example":""}},{"name":"to","in":"query","description":"UNIX timestamp in seconds till when payments are to be fetched.","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments#fetch-multiple-payments","api_endpoint":"https://api.razorpay.com/v1/payments/"},"summary":"Fetch all Payments","description":"Fetch all Payments","security":[{"bearerAuth":[]}]}},"/v1/payments/{pay_id}":{"get":{"tags":["Payments"],"parameters":[{"name":"pay_id","in":"path","description":"Unique identifier of the payment to be retrieved.","required":true,"schema":{"type":"string","example":""}},{"name":"expand[]","in":"query","description":"applicable for EMI payments.offers - Expanded Offer details; applicable when an offer was applied to the payment.","schema":{"type":"array","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments#fetch-a-payment","api_endpoint":"https://api.razorpay.com/v1/payments/:pay_id"},"summary":"Fetch Payment by ID","description":"Fetch Payment by ID","security":[{"bearerAuth":[]}]},"patch":{"tags":["Payments"],"parameters":[{"name":"pay_id","in":"path","description":"Unique identifier of the payment for which the Notes field should be updated.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments#update-the-payment","api_endpoint":"https://api.razorpay.com/v1/payments/:pay_id"},"summary":"Update Payment","description":"Update Payment","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"notes":{"type":"object","description":"Contains user-defined fields and is stored for reference purposes.","required":true,"properties":{"key":{"type":"string","description":"Arbitrary key name. Maximum 15 key-value pairs, 256 characters each."},"value":{"type":"string","description":"Value for the key. Maximum 256 characters."}}}}},"example":{"notes":{}}}}}}},"/v1/payments/{pay_id}/card":{"get":{"tags":["Payments"],"parameters":[{"name":"pay_id","in":"path","description":"Unique identifier of the payment for which you want to retrieve card details.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments#fetch-card-details-of-a-payment","api_endpoint":"https://api.razorpay.com/v1/payments/:pay_id/card"},"summary":"Fetch Card Details for a Payment","description":"Fetch Card Details for a Payment","security":[{"bearerAuth":[]}]}},"/v1/payments/{pay_id}/capture":{"post":{"tags":["Payments"],"parameters":[{"name":"pay_id","in":"path","description":"Unique identifier of the payment to be captured.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments#capture-a-payment","api_endpoint":"https://api.razorpay.com/v1/payments/:pay_id/capture"},"summary":"Capture a Payment","description":"Capture a Payment","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"amount":{"type":"number","description":"The amount to be captured (should be equal to the authorised amount; in the smallest unit of the chosen currency)."},"currency":{"type":"string","description":"ISO code of the currency in which the payment was made. Refer to the list of supported currencies.","required":true}}},"example":{"amount":"","currency":""}}}}}},"/v1/plans":{"post":{"tags":["Plans"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#create-a-plan","api_endpoint":"https://api.razorpay.com/v1/plans"},"summary":"Create Plan","description":"Create Plan","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"interval":{"type":"number","description":"This; combined with period; defines the frequency. If the billing cycle is 2 months; the value should be 2.","required":true},"notes":{"type":"object","description":"Notes you can enter for the contact for future reference. This is a key-value pair. You can enter a maximum of 15 key-value pairs. For example; \"note_key\"- \"Beam me up Scotty”.","properties":{"key":{"type":"string","description":"Arbitrary key name. Maximum 15 key-value pairs, 256 characters each."},"value":{"type":"string","description":"Value for the key. Maximum 256 characters."}}},"period":{"type":"string","description":"This combined with interval; defines the frequency. Possible values- daily/weekly/monthly/yearly","required":true},"item":{"type":"","description":{"text":"Description for the plan item.","type":"string"}}}},"example":{"interval":"","notes":{},"period":"","item":""}}}}},"get":{"tags":["Plans"],"parameters":[{"name":"count","in":"query","description":"The number of plans to be fetched. Default value is 10. Maximum value is 100. This can be used for pagination in combination with skip.","schema":{"type":"number","example":""}},{"name":"form","in":"query","description":"The Unix timestamp from when plans are to be fetched.","schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"The number of plans to be skipped. Default value is 0. This can be used for pagination in combination with count.","schema":{"type":"number","example":""}},{"name":"to","in":"query","description":"The Unix timestamp till when plans are to be fetched.","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#fetch-all-plans","api_endpoint":"https://api.razorpay.com/v1/plans"},"summary":"Fetch All Plans","description":"Fetch All Plans","security":[{"bearerAuth":[]}]}},"/v1/plans/{plan_id}":{"get":{"tags":["Plans"],"parameters":[{"name":"plan_id","in":"path","description":"The unique identifier of the plan. For example; plan_00000000000001.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#fetch-a-plan-by-id","api_endpoint":"https://api.razorpay.com/v1/plans/:plan_id"},"summary":"Fetch Plans by ID","description":"Fetch Plans by ID","security":[{"bearerAuth":[]}]}},"/v1/payments/{pay_id}/refund":{"post":{"tags":["Refunds"],"parameters":[{"name":"pay_id","in":"path","description":"The unique identifier of the payment which needs to be refunded.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/refunds#create-an-instant-refund","api_endpoint":"https://api.razorpay.com/v1/payments/:pay_id/refund"},"summary":"Create an Instant Refund","description":"Create an Instant Refund","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"amount":{"type":"number","description":"The amount to be refunded. Amount should be in the smallest unit of the currency in which the payment was made. Required in case of partial refund.For a partial refund enter a value lesser than the payment amount. For example; if the payment amount is ₹1200 and you want to refund only ₹200; you must pass 20000.For full refund; enter the entire payment amount. If amount parameter is not passed; the entire payment amount will be refunded."},"receipt":{"type":"string","description":"A unique identifier provided by you for your internal reference."},"speed":{"type":"string","description":"Here; it must be optimum. Indicates that the refund will be processed at an optimal speed based on Razorpay's internal fund transfer logic. If the refund can be processed instantly; Razorpay will do so irrespective of the payment method used to make the payment. If an instant refund is not possible; Razorpay will initiate a refund that is processed at the normal speed.","required":true}}},"example":{"amount":"","receipt":"","speed":""}}}}}},"/v1/refunds":{"get":{"tags":["Refunds"],"parameters":[{"name":"count","in":"query","description":"The number of refunds to fetch. You can fetch a maximum of 100 refunds.","schema":{"type":"number","example":""}},{"name":"from","in":"query","description":"Unix timestamp at which the refunds were created.","schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"The number of refunds to be skipped.","schema":{"type":"number","example":""}},{"name":"to","in":"query","description":"Unix timestamp till which the refunds were created.","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/refunds#fetch-all-refunds","api_endpoint":"https://api.razorpay.com/v1/refunds"},"summary":"Fetch Refunds","description":"Fetch Refunds","security":[{"bearerAuth":[]}]}},"/v1/refunds/{rfnd_id}":{"get":{"tags":["Refunds"],"parameters":[{"name":"rfnd_id","in":"path","description":"Unique identifier of the refund which is to be retrieved.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/refunds#fetch-refund-by-id","api_endpoint":"https://api.razorpay.com/v1/refunds/:rfnd_id"},"summary":"Fetch Refund by ID","description":"Fetch Refund by ID","security":[{"bearerAuth":[]}]},"patch":{"tags":["Refunds"],"parameters":[{"name":"rfnd_id","in":"path","description":"Unique identifier of the refund for which the Notes field should be updated.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/refunds#update-refund","api_endpoint":"https://api.razorpay.com/v1/refunds/:rfnd_id"},"summary":"Update Refund","description":"Update Refund","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"notes":{"type":"object","description":"Additional information to be modified or added as part of Notes field in key-pair format. Know more about notes.","required":true,"properties":{"key":{"type":"string","description":"Arbitrary key name. Maximum 15 key-value pairs, 256 characters each."},"value":{"type":"string","description":"Value for the key. Maximum 256 characters."}}}}},"example":{"notes":{}}}}}}},"/v1/payments/{pay_id}/refunds/{rfnd_id}":{"get":{"tags":["Refunds"],"parameters":[{"name":"pay_id","in":"path","description":"Unique identifier of the payment for which the refund has been made.","required":true,"schema":{"type":"string","example":""}},{"name":"rfnd_id","in":"path","description":"Unique identifier of the refund to be retrieved.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/refunds#fetch-a-specific-refund-for-a-payment","api_endpoint":"https://api.razorpay.com/v1/payments/:pay_id/refunds/:rfnd_id"},"summary":"Fetch a Specific Refund for a Payment","description":"Fetch a Specific Refund for a Payment","security":[{"bearerAuth":[]}]}},"/v1/payments/{pay_id}/refunds":{"get":{"tags":["Refunds"],"parameters":[{"name":"pay_id","in":"path","description":"Unique identifier of the payment for which refund has been requested","required":true,"schema":{"type":"string","example":""}},{"name":"count","in":"query","description":"The number of refunds to fetch for the payment.","schema":{"type":"number","example":""}},{"name":"form","in":"query","description":"Unix timestamp at which the refunds were created.","schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"The number of refunds to be skipped for the payment.","schema":{"type":"number","example":""}},{"name":"to","in":"query","description":"Unix timestamp till which the refunds were created.","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/refunds#fetch-all-refunds","api_endpoint":"https://api.razorpay.com/v1/payments/:pay_id/refunds"},"summary":"Fetch Multiple Refunds for a Payment","description":"Fetch Multiple Refunds for a Payment","security":[{"bearerAuth":[]}]}},"/v1/settlements/ondemand":{"post":{"tags":["Settlements"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/settlements/instant#create-an-instant-settlement","api_endpoint":"https://api.razorpay.com/v1/settlements/ondemand"},"summary":"Create Instant Settlement","description":"Create Instant Settlement","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"amount":{"type":"number","description":"The amount; in paise; you want settled to your account.","required":true},"description":{"type":"string","description":"This is a custom note you can pass for the instant settlement for your reference. For example; Need this to make vendor payments.Maximum length- 30 characters.Allowed characters- a-z; A-Z; 0-9 and space."},"notes":{"type":"object","description":"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- Beam me up Scotty.","properties":{"key":{"type":"string","description":"Arbitrary key name. Maximum 15 key-value pairs, 256 characters each."},"value":{"type":"string","description":"Value for the key. Maximum 256 characters."}}},"settle_full_balance":{"type":"boolean","description":"Possible value- true- Razorpay will settle the maximum amount possible. Values passed in the amount parameter are ignored.false (default value)- Razorpay will settle the amount requested in the amount parameter.","enum":[true,false]}}},"example":{"amount":"","description":"","notes":{},"settle_full_balance":""}}}}},"get":{"tags":["Settlements"],"parameters":[{"name":"count","in":"query","description":"Number of instant settlement records to be retrieved.Default value- 10.Maximum value- 100.This can be used for pagination; in combination with skip.","schema":{"type":"number","example":""}},{"name":"expand[]=ondemand_payouts","in":"query","description":"Pass this if you want to fetch payout details as part of the response.","schema":{"type":"string","example":""}},{"name":"form","in":"query","description":"Unix timestamp (in seconds) from when instant settlements are to be retrieved.","schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of instant settlement records to be skipped.Default value- 0 This can be used for pagination; in combination with count.","schema":{"type":"number","example":""}},{"name":"to","in":"query","description":"Unix timestamp (in seconds) till when instant settlements are to be retrieved.","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/settlements/instant#fetch-all-instant-settlements","api_endpoint":"https://api.razorpay.com/v1/settlements/ondemand"},"summary":"Fetch all Instant Settlements","description":"Fetch all Instant Settlements","security":[{"bearerAuth":[]}]}},"/v1/settlements/ondemand/{sod_id}":{"get":{"tags":["Settlements"],"parameters":[{"name":"sod_id","in":"path","description":"The unique identifier for the instant settlement transaction. For example; setlod_FNj7g2YS5J67Rz.","required":true,"schema":{"type":"string","example":""}},{"name":"expand[]=ondemand_payouts","in":"query","description":"Pass this if you want to fetch payout details as part of the response.","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/settlements/instant#fetch-instant-settlement-by-id","api_endpoint":"https://api.razorpay.com/v1/settlements/ondemand/:sod_id"},"summary":"Fetch Instant Settlement by ID","description":"Fetch Instant Settlement by ID","security":[{"bearerAuth":[]}]}},"/v1/settlements/recon/combined":{"get":{"tags":["Settlements"],"parameters":[{"name":"count","in":"query","description":"Specifies the number of available settlements to be fetched. Maximum count can be 1000.","schema":{"type":"number","example":""}},{"name":"month","in":"query","description":"The month the settlement was received in the MM format. For example; 06.'\nday","required":true,"schema":{"type":"number","example":"","items":{"type":"string","enum":["number"]}}},{"name":"skip","in":"query","description":"Specifies the number of available settlements to be skipped when fetching a count.","schema":{"type":"number","example":""}},{"name":"year","in":"query","description":"The year the settlement was received in the YYYY format. For example; 2022.","required":true,"schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/settlements#settlement-recon","api_endpoint":"https://api.razorpay.com/v1/settlements/recon/combined"},"summary":"Settlements Recon","description":"Settlements Recon","security":[{"bearerAuth":[]}]}},"/v1/settlements/{setl_id}":{"get":{"tags":["Settlements"],"parameters":[{"name":"setl_id","in":"path","description":"The unique identifier of the settlement to be retrieved.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/settlements#fetch-settlement-using-id","api_endpoint":"https://api.razorpay.com/v1/settlements/:setl_id"},"summary":"Fetch Settlement by ID","description":"Fetch Settlement by ID","security":[{"bearerAuth":[]}]}},"/v1/settlements":{"get":{"tags":["Settlements"],"parameters":[{"name":"count","in":"query","description":"Number of settlement records to be fetched. Default value- 10 Maximum value- 100This can be used for pagination; in combination with skip.","schema":{"type":"number","example":""}},{"name":"form","in":"query","schema":{"type":"number","example":""}},{"name":"skip","in":"query","description":"Number of settlement records to be skipped.Default value- 0 This can be used for pagination; in combination with count.","schema":{"type":"number","example":""}},{"name":"to","in":"query","description":"Unix timestamp (in seconds) till when settlements are to be fetched.","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/settlements#fetch-all-settlements","api_endpoint":"https://api.razorpay.com/v1/settlements"},"summary":"Fetch All Settlements","description":"Fetch All Settlements","security":[{"bearerAuth":[]}]}},"/v1/subscriptions":{"post":{"tags":["Subscriptions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#create-a-subscription-link","api_endpoint":"https://api.razorpay.com/v1/subscriptions"},"summary":"Create Subscription Link","description":"Create Subscription Link","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"customer_notify":{"type":"boolean","description":"Indicates whether the communication to the customer would be handled by you or us. Possible values- 0- communication handled by you.1 (default)- communication handled by Razorpay.","enum":[true,false]},"expire_by":{"type":"number","description":"Unix timestamp that indicates till when the customer can make the authorisation payment. For example; 1581013800. Do not pass any value if you do not want to set an expiry date."},"notes":{"type":"object","description":"Notes you can enter for the contact for future reference. This is a key-value pair. You can enter a maximum of 15 key-value pairs. For example, 'note_key': 'Beam me up Scotty' ","properties":{"key":{"type":"string","description":"Arbitrary key name. Maximum 15 key-value pairs, 256 characters each."},"value":{"type":"string","description":"Value for the key. Maximum 256 characters."}}},"notify_info":{"type":"object","description":"The customer's email and phone number to which notifications are to be sent. Use this array only if you have set the customer_notify parameter to 1. That is Razorpay sends notifications to the customer.","properties":{"notify_phone":{"type":"string","description":"Customer's phone number to which notifications are to be sent. Only used when customer_notify is true."},"notify_email":{"type":"string","description":"Customer's email address to which notifications are to be sent. Only used when customer_notify is true."}}},"offer_id":{"type":"string","description":"The unique identifier of the offer that is linked to the Subscription. You can obtain this from the Dashboard. For example, offer_JHD834hjbxzhd38d."},"plan_id":{"type":"string","description":"The unique identifier of a plan that should be linked to the Subscription. For example; plan_00000000000001.","required":true},"quantity":{"type":"number","description":"The number of times the customer should be charged the plan amount per invoice. For example; a customer subscribes to use software. The charges are ₹100/month/license. The customer wants 5 licenses. You should pass 5 as the quantity. The customer is charged ₹500 (5 x ₹100) monthly. By default; this value is set to 1."},"start_at":{"type":"number","description":"Unix timestamp that indicates from when the Subscription should start. If not passed the Subscription starts immediately after the authorisation payment. For example; 1581013800"},"total_count":{"type":"number","description":"The number of billing cycles for which the customer should be charged. For example; if a customer is buying a 1-year subscription billed on a bi-monthly basis; this value should be 6.","required":true}}},"example":{"customer_notify":"","expire_by":"","notes":{},"notify_info":{},"offer_id":"","plan_id":"","quantity":"","start_at":"","total_count":""}}}}},"get":{"tags":["Subscriptions"],"parameters":[{"name":"count","in":"query","description":"The number of Subscriptions to be fetched. Default value is 10. Maximum value is 100. This can be used for pagination; in combination with skip.","schema":{"type":"number","example":""}},{"name":"form","in":"query","description":"The Unix timestamp from when Subscriptions are to be fetched.","schema":{"type":"number","example":""}},{"name":"plan_id","in":"query","description":"The unique identifier of the plan for which you want to retrieve all the Subscriptions","schema":{"type":"string","example":""}},{"name":"skip","in":"query","description":"The number of Subscriptions to be skipped. Default value is 0. This can be used for pagination; in combination with count.","schema":{"type":"number","example":""}},{"name":"to","in":"query","description":"The Unix timestamp till when Subscriptions are to be fetched.","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#fetch-all-subscriptions","api_endpoint":"https://api.razorpay.com/v1/subscriptions"},"summary":"Fetch All Subscriptions","description":"Fetch All Subscriptions","security":[{"bearerAuth":[]}]}},"/v1/subscriptions/{sub_id}":{"get":{"tags":["Subscriptions"],"parameters":[{"name":"sub_id","in":"path","description":"The unique identifier linked to a Subscription. For example; sub_00000000000001.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#fetch-a-subscription-by-id","api_endpoint":"https://api.razorpay.com/v1/subscriptions/:sub_id"},"summary":"Fetch Subscriptions by ID","description":"Fetch Subscriptions by ID","security":[{"bearerAuth":[]}]},"patch":{"tags":["Subscriptions"],"parameters":[{"name":"sub_id","in":"path","description":"The unique identifier linked to a Subscription. For example; sub_00000000000001.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#update-a-subscription","api_endpoint":"https://api.razorpay.com/v1/subscriptions/:sub_id"},"summary":"Update Subscription","description":"Update Subscription","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"customer_notify":{"type":"boolean","description":"Represents who sends notifications to the customer. Possible values-1 (default)- Notifications sent by Razorpay.0- Notifications sent by you.","enum":[true,false]},"offer_id":{"type":"string","description":"The unique identifier of the offer that should be linked to the Subscription. You can obtain this from the Dashboard. For example; offer_JHD834hjbxzhd38d."},"plan_id":{"type":"string","description":"The unique identifier of the new plan that should be linked to the Subscription. For example; plan_00000000000001."},"quantity":{"type":"number","description":"The number of times the plan should be linked to the Subscription. For example; if the plan is ₹100/user/month and the customer has 5 users; you should pass 5 as the quantity to have the customer charged ₹500 (5 x ₹100) monthly. By default; this value is set to 1"},"remaining_count":{"type":"number","description":"This parameter is used to update the total_count for a Subscription. For example; let us consider a monthly Subscription with 12 billing cycles. The Subscription has been charged successfully 4 times and 3 more invoices have been issued; but have not been charged. The remaining count in such cases is 5. However; you can overwrite this value using this parameter"},"schedule_change_at":{"type":"string","description":"Represents when the Subscription should be updated. now (default) Updates the Subscription immediately.cycle_end- Updates the Subscription at the end of the current billing cycle."},"start_at":{"type":"number","description":"Unix timestamp. The new start date for the Subscription."}}},"example":{"customer_notify":"","offer_id":"","plan_id":"","quantity":"","remaining_count":"","schedule_change_at":"","start_at":""}}}}}},"/v1/subscriptions/{sub_id}/cancel":{"post":{"tags":["Subscriptions"],"parameters":[{"name":"sub_id","in":"path","description":"The unique identifier linked to a Subscription. For example; sub_00000000000001.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#cancel-a-subscription","api_endpoint":"https://api.razorpay.com/v1/subscriptions/:sub_id/cancel"},"summary":"Cancel Subscription","description":"Cancel Subscription","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"cancel_at_cycle_end":{"type":"boolean","description":"Use this parameter to cancel a Subscription at the end of a billing cycle. Possible values-0 (default)- Cancel the subscription immediately.1- Cancel the subscription at the end of the current billing cycle.","enum":[true,false]}}},"example":{"cancel_at_cycle_end":""}}}}}},"/v1/subscriptions/{sub_id}/retrieve_scheduled_changes":{"get":{"tags":["Subscriptions"],"parameters":[{"name":"sub_id","in":"path","description":"The unique identifier linked to a Subscription. For example; sub_00000000000001.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#fetch-details-of-a-pending-update","api_endpoint":"https://api.razorpay.com/v1/subscriptions/:sub_id/retrieve_scheduled_changes"},"summary":"Fetch Details of a Pending Update","description":"Fetch Details of a Pending Update","security":[{"bearerAuth":[]}]}},"/v1/subscriptions/{sub_id}/cancel_scheduled_changes":{"post":{"tags":["Subscriptions"],"parameters":[{"name":"sub_id","in":"path","description":"The unique identifier linked to a Subscription. For example; sub_00000000000001.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#cancel-an-update","api_endpoint":"https://api.razorpay.com/v1/subscriptions/:sub_id/cancel_scheduled_changes"},"summary":"Cancel Pending Update","description":"Cancel Pending Update","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/v1/subscriptions/{sub_id}/pause":{"post":{"tags":["Subscriptions"],"parameters":[{"name":"sub_id","in":"path","description":"The unique identifier linked to a Subscription. For example; sub_00000000000001.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#pause-a-subscription","api_endpoint":"https://api.razorpay.com/v1/subscriptions/:sub_id/pause"},"summary":"Pause a Subscription","description":"Pause a Subscription","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"pause_at":{"type":"string","description":"The value should be now to pause a Subscription immediately."}}},"example":{"pause_at":""}}}}}},"/v1/subscriptions/{sub_id}/resume":{"post":{"tags":["Subscriptions"],"parameters":[{"name":"sub_id","in":"path","description":"The unique identifier linked to a Subscription. For example; sub_00000000000001.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#resume-a-subscription","api_endpoint":"https://api.razorpay.com/v1/subscriptions/:sub_id/resume"},"summary":"Resume a Subscription","description":"Resume a Subscription","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"resume_at":{"type":"string","description":"The value should be now to resume a Subscription immediately."}}},"example":{"resume_at":""}}}}}},"/v1/subscriptions/{sub_id}/{offer_id}":{"delete":{"tags":["Subscriptions"],"parameters":[{"name":"offer_id","in":"path","description":"The unique identifier of the offer you want remove from the Subscription. For example; offer_JHD834hjbxzhd38d.","required":true,"schema":{"type":"string","example":""}},{"name":"sub_id","in":"path","description":"The unique identifier of the Subscription from which you want to remove the offer. For example; sub_00000000000001.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://razorpay.com/docs/api/payments/subscriptions#delete-an-offer-linked-to-a-subscription","api_endpoint":"https://api.razorpay.com/v1/subscriptions/:sub_id/:offer_id"},"summary":"Delete an Offer Linked to a Subscription","description":"Delete an Offer Linked to a Subscription","security":[{"bearerAuth":[]}]}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}