Payment Capture Settings

Configure auto and manual payment capture settings from Dashboard and using APIs.


Razorpay enables you to accept online payments from your customers. When a customer makes a payment, it usually flows through different states. Know more about

.

By default, once your customer completes a payment, it is automatically moved to the 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 authorized state. Know more about .
  • Specific business use case
    Some businesses such as those in the Ecommerce industry, may retain the payment in the authorized state and later move them to the captured state.

Handy Tips

You must ensure that all payments in the authorized state are moved to captured state within 3 days of creation. This is mandatory because payments that are not captured within this time period will be refunded automatically to customers.

You can configure Payment Capture settings on the Razorpay Dashboard. You can choose to:

Handy Tips

Only a Razorpay account owner can configure payment capture settings on the Razorpay Dashboard. Users with other roles are not allowed to configure this setting.

OptionDescription
Auto-capture all paymentsAll 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 speedPayments 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.

Prerequisites

  • Payment Capture settings are applicable only for payments created using the Orders API.
  • For Direct Settlement merchants, payments will be auto-captured even if they are created without using the Orders API.

You can use this setting to capture all authorized payments automatically. This eliminates the time and effort spent manually capturing payments. This is the default setting for all customers.

 Auto-capture all payments process flow

Watch this video to know how to set up the Automatic Capture option.

To auto-capture all authorized payments:

  1. Log in to the .
  2. Navigate to the Settings option and scroll to the Payments Capture option.
  3. Click the Change button next to Automatic Capture.
  4. Under Automatic Capture, click the drop-down and select the time period in the Capture all payments authorised within field. For example, 3 days.
  5. Click Next.
  6. Select Refund Automatically and click Next.
  7. Select Normal Refund as the Refund Speed.
  8. Click Save.

Once the payment is created, you can:

  • auto-capture payments that are authorized within a certain time period, and
  • manually capture payments that are authorized after that time period.

You can do this by setting up custom timeouts for automatic and manual capture.

Let us say you only want to auto-capture payments that are authorized within 3 days from creation.

Capture Settings
  • Select Automatic Capture
  • Automatic capture timeout = 3 days.
Payments auto-refundedIf payments are authorized after 3 days.
Auto Capture Timeout process flow

Watch this video to see how to set up the Automatic Capture with Timeout option.

Let us say you want to:

  • Auto-capture payments that are authorized within 2 days from creation.
  • Manually capture payments that are authorized within 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 authorized after 3 days.
Auto and Manual Capture Timeout process flow

Watch this video to see how to set up the Automatic and Manual Capture with Timeout option.

To configure capture settings:

  1. Log in to your Dashboard.
  2. Navigate to the Settings option and scroll to the Payments Capture option.
  3. Click the Change button next to Automatic Capture.
  4. Under Automatic Capture, click the drop-down and select the time period in the Capture all payments authorised within field. For example, 2 days.
  5. Click Next.
  6. Select Capture manually via dashboard or API.
  7. Click the drop-down and select the time period in the Capture payments manually authorised within field. For example, 3 days.
  8. Click Next.
  9. Select Normal Refund as the Refund Speed.
  10. Click Save.

You can use this setting to capture authorized payments manually.

Watch Out!

Manual capture of payments is not supported on

. All bank transfer payments are auto-captured.

Let us say you only want to manually capture payments that are authorized 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 authorized after 3 days.
Manual Capture Timeout process flow

Watch this video to set up the Manual Capture option.

To set up the manual capture:

  1. Log in to the .
  2. Navigate to the Settings option and scroll to the Payments Capture option.
  3. Click the Change button next to Automatic Capture.
  4. Select the Manual Capture option.
  5. Set the manual capture timeout to 3 days and click Next.
  6. Select Normal Refund as the Refund Speed.
  7. Click Save.

You can manually capture payments in the authorized state using our

or from the . All payments that are not captured within the manual timeout period will be auto-refunded.

Capture values passed in the

take precedence over the Payment Capture settings configured on the Razorpay Dashboard. You can use this to change the capture settings for individual payments.


Was this page helpful?