captured state.
However, the payment can remain in the authorized state in the following scenarios:
-
Late authorization
Due to external factors such as network issues or technical errors, Razorpay may not immediately receive payment status from the bank. In this case, Razorpay polls the APIs intermittently for 3 days to check the status. If we receive the payment status as successful, the payment is moved to the
authorizedstate. Know more about late authorization. -
Specific business use case
Some businesses such as those in the Ecommerce industry, may retain the payment in the
authorizedstate and later move them to thecapturedstate.
Payment Capture Settings
Handy TipsAuto-capture all payments | All payments
Auto-capture timeouts | - Allows you to define custom auto-capture timeout.
Manual capture timeout | - Allows you to define custom manual capture timeout.
Auto-refund speed | Payments in theAuto-capture all payments | All payments
Auto-capture timeouts | - Allows you to define custom auto-capture timeout.
Auto-refund speed | Payments in the
- Only the Razorpay account owner can configure payment capture settings on the Dashboard.
- Payment Capture settings are applicable only for payments created using the Orders API.
Option | Description
Auto-capture all payments | All payments authorized within 3 days from the time of creation are auto-captured.
Auto-capture timeouts | - Allows you to define custom auto-capture timeout.- The minimum value is 12 minutes.
- The maximum value (default) is 3 days.
Manual capture timeout | - Allows you to define custom manual capture timeout.
- The minimum value is 12 minutes.
- The maximum value (default) is 3 days.
Auto-refund speed | Payments in the
authorized state are auto-refunded after the timeout. The available option is Normal Refund where the payment is refunded to your customer in 5-7 working days. The refund speed selected here is only applicable to payments that are auto-refunded.account owner can configure payment capture settings on the Dashboard.- Payment Capture settings are applicable only for payments created using the Orders API.
Option | Description
Auto-capture all payments | All payments authorized within 3 days from the time of creation are auto-captured.
Auto-capture timeouts | - Allows you to define custom auto-capture timeout.- The minimum value is 12 minutes.
- The maximum value (default) is 3 days.
Auto-refund speed | Payments in the
authorized state are auto-refunded after the timeout. The available option is Normal Refund where the payment is refunded to your customer in 5-7 working days. The refund speed selected here is only applicable to payments that are auto-refunded.Auto-capture all Payments
You can use this setting to capture allauthorized payments automatically. This eliminates the time and effort spent manually capturing payments. This is the default setting for all customers.
Watch this video to know how to set up the Automatic Capture option.
To auto-capture all authorized payments:
- Log in to the Dashboard.
- Navigate to the Account & Settings option and scroll to the Payments Capture option.
- Click the Change button next to Automatic Capture.
- Under Automatic Capture, click the drop-down and select the time period in the Capture all payments authorised within field. For example, 3 days.
- Click Next.
- Select Refund Automatically and click Next.
- Select Normal Refund as the Refund Speed.
- Click Save.
Auto-Capture with Custom Timeouts
Once the payment iscreated, you can:
- Auto-capture payments that are
authorizedwithin a certain time period, and - Manually capture payments that are
authorizedafter that time period.
Auto-capture Timeout
Let us say you only want to auto-capture payments that areauthorized within 3 days from creation.
Capture Settings | - Select Automatic Capture
- Automatic capture timeout = 3 days.
Payments auto-refunded | If payments are
authorized after 3 days.
Watch this video to see how to set up the Automatic Capture with Timeout option.
Auto-capture + Manual Capture Timeouts
Let us say you want to:- Auto-capture payments that are
authorizedwithin 2 days from creation. - Manually capture payments that are
authorizedwithin 3 days from creation.
Capture Settings | - Select Automatic Capture
- Automatic capture timeout = 2 days.
- Manual capture timeout = 3 days.
Payments auto-refunded if | - Payments not
captured by you within 3 days.
- Payments are
authorizedafter 3 days.
To configure capture settings:
- Log in to your Dashboard.
- Navigate to the Account & Settings option and scroll to the Payments Capture option.
- Click the Change button next to Automatic Capture.
- Under Automatic Capture, click the drop-down and select the time period in the Capture all payments authorised within field. For example, 2 days.
- Click Next.
- Select Capture manually via dashboard or API.
- Click the drop-down and select the time period in the Capture payments manually authorised within field. For example, 3 days.
- Click Next.
- Select Normal Refund as the Refund Speed.
- Click Save.
Manually Capture all Payments
You can use this setting to captureauthorized payments manually.
Manual Capture Timeout
Let us say you only want to manually capture payments that areauthorized within 3 days from creation. To do this, you should set the manual capture timeout as 3 days.
Capture Settings | - Select Manual Capture
- Manual capture timeout = 3 days.
Payments auto-refunded if | - Payments not
captured by you within 3 days.
- Payments are
authorizedafter 3 days.
To set up the manual capture:
- Log in to the Dashboard.
- Navigate to the Account & Settings option and scroll to the Payments Capture option.
- Click the Change button next to Automatic Capture.
- Select the Manual Capture option.
- Set the manual capture timeout to 3 days and click Next.
- Select Normal Refund as the Refund Speed.
- Click Save.
authorized state using our Capture API or from the Dashboard. All payments that are not captured within the manual timeout period will be auto-refunded.
Configure Payment Capture Settings using Orders API
Capture values passed in the Orders API take precedence over the Payment Capture settings configured on the Dashboard. You can use this to change the capture settings for individual payments.Related Information
- How Payment Gateway Works
- Payment States
- Refunds
- Manually capture payments in the
authorizedstate using the Capture API or from the Dashboard - Set up and Subscribe to Webhook events