API ReferenceIntegrationsKnowledge Base

1. Authorization Transaction

The authorization transaction allows us to authenticate the customer's selected payment method, ensuring that we can charge them recurring payments. The authorization transaction can be created:

Subsequent payments can be charged without the need of any intervention from the customer. However, subsequent payments need to be created manually by you. To do this, first fetch and check the status of a token and then charge the token.

Using Razorpay Standard Checkout#

The authorization transaction flow is shown below:

To allow customers to complete authorization transaction via your Checkout, you have to:

  1. Create a customer. This returns a customer_id.
  2. Create an order. This returns an order_id. The order must be created for:
    • A minimum of ₹1 for cards and UPI.
    • ₹0 for Emandate and paper NACH.
  3. Pass the customer_id, order_id and a few additional parameters in your Checkout to create the authorization payment. The customer completes the authorization payment, which generates a token. Customers can complete the authorization payment via:
    • Emandate.
    • Card.
    • Paper NACH. The following additional steps have to be completed for NACH:
      1. The customer either downloads a pre-filled NACH form or you can send it to the customer.
      2. The customer signs the pre-filled NACH form.
      3. The customer either uploads the signed form or sends it to you to upload for processing.
    • UPI.

Refer to the API section for more details.

Authorization Payment Statuses#

Once the customer has made the Authorization Payment, it moves through the following states as per the payment flow:

Status

Description

Webhook

Created

Payment is created when a customer enters and submits the payment information.

NA

Authorized

Payment is authorized when the customer’s payment details are successfully authenticated by the bank.

payment.authorized

Captured

Indicates that the payment is verified by you.
Once a payment is captured you can retrieve the token.

payment.captured

or

order.paid

Failed

Indicates that the payment has failed.
If the payment has failed, you need to create an authorization transaction again.

payment.failed

Using a Registration Link#

Registration Links are securely generated web addresses that allow your customers to complete the authorization transaction. Registration links can be sent via SMS or email and can be created from the Dashboard or API.

To allow customers to complete the authorization transaction via a registration link, you have to:

  1. Create a registration link and send it to your customer. The customer completes the authorization payment, which generates a token. Customers can complete the authorization payment via:
    1. Emandate.
    2. Card.
    3. Paper NACH. The following additional steps have to be completed for NACH:
      1. The customer either downloads a pre-filled NACH form or you can send it to the customer.
      2. The customer signs the pre-filled NACH form.
      3. The customer either uploads the signed form or sends it to you to upload for processing.
    4. UPI

No need to create a customer and order separately:
If you use a registration link to create the authorization transaction, Razorpay automatically creates a customer and the order for you.

Registration Link Statuses#

A registration link moves through the following states during its life cycle:

Status

Description

Webhook

Issued

A registration Link is created and sent to the customer.

NA

Paid

Payment is made for the issued registration Link.
Once the registration Link is paid, search for Token corresponding to the payment.

invoice.paid

Cancelled

The registration link has been canceled. In such cases, you need to create a registration link again.

NA

Expired

The registration link has expired. You can set an expiry timestamp at the time of creation.

invoice.expired