Get Started With Optimizer

Integrate Optimizer on your website to start accepting payments.

Available in🇮🇳 India

Check the prerequisites and the integration steps for Optimizer.

Prerequisites

• Create a Razorpay account.
• If you are an existing Razorpay user, please raise a request with our support team to get this feature activated on your Razorpay account.

Integration Steps

To accept payments using Optimizer, follow the steps given below:

1. Integrate with Razorpay Payment Gateway.
2. Add Payment Providers.
3. Configure Routing rules.

Step 1: Integrate With Razorpay Payment Gateway

You can start accepting payments by integrating your website, app, or ecommerce store with the Razorpay Payment Gateway through any of the integration methods available.

Payments API

Payments APIs are used to capture and fetch payments. The payment entity has one extra field with Optimizer to identify the payment provider through which the payment is processed.

Given below is the additional response parameter apart from the Payment Entity:

gateway_provider : string The payment provider used to process the payment. Possible values:

• payu
• cashfree
• paytm
• pinelabs
• ccavenue
• ingenico
• billdesk_optimizer

Refer to Payments Entity for the rest of the parameters.

Payment Success

{
  "id": "pay_JTiNyKvjH6p3GD",
  "entity": "payment",
  "amount": 100,
  "currency": "INR",
  "status": "captured",
  "order_id": null,
  "invoice_id": null,
  "international": false,
  "method": "card",
  "amount_refunded": 0,
  "refund_status": null,
  "captured": true,
  "description": null,
  "card_id": "card_JTiNyNf65C8Qkn",
  "bank": null,
  "wallet": null,
  "vpa": null,
  "email": "[e-mail]",
  "contact": "[phone]",
  "notes": [],
  "fee": 0,
  "tax": 0,
  "error_code": null,
  "error_description": null,
  "error_source": null,
  "error_step": null,
  "error_reason": null,
  "acquirer_data": {
    "auth_code": null
  },
  "gateway_provider": "payu",
  "created_at": 1652227221
}

Webhooks

You can use Webhooks to configure and receive notifications when a specific event occurs. When an event is triggered, we send an HTTP POST payload in JSON to the webhook’s configured URL. You can set up Webhooks from the Dashboard.

Given below is the sample payload for webhook events for Optimizer. All the parameters and events will remain the same as shown in the sample payloads for payment webhooks except for one additional parameter, gateway_provider.

Webhook Sample Payload

{
  "entity": "event",
  "account_id": "acc_BFQ7uQEaa7j2z7",
  "event": "payment.authorized",
  "contains": [
    "payment"
  ],
  "payload": {
    "payment": {
      "entity": {
        "id": "pay_DESlfW9H8K9uqM",
        "entity": "payment",
        "amount": 100,
        "currency": "INR",
        "status": "authorized",
        "order_id": "order_DESlLckIVRkHWj",
        "invoice_id": null,
        "international": false,
        "method": "netbanking",
        "amount_refunded": 0,
        "refund_status": null,
        "captured": false,
        "description": null,
        "card_id": null,
        "bank": "HDFC",
        "wallet": null,
        "vpa": null,
        "email": "[e-mail]",
        "contact": "[phone]",
        "notes": [],
        "fee": null,
        "tax": null,
        "error_code": null,
        "error_description": null,
        "error_source": null,
        "error_step": null,
        "error_reason": null,
        "acquirer_data": {
          "bank_transaction_id": "0125836177"
        },
        "gateway_provider": "payu",
        "created_at": 1567674599
      }
    }
  },
  "created_at": 1567674606
}

Step 2: Add Payment Providers

Watch this video to know how to add payment providers and configure rules using Optimizer.

The Razorpay Dashboard offers a self-serve flow to add Payment Providers by submitting your details. This process is secure, and the details you add are fully encrypted which is only visible on your Dashboard. Know more about Razorpay Security.

Step 3: Configure Routing Rules

Create your rules on the Razorpay Dashboard to dynamically route transactions using different parameters like payment method, amount, issuer, and more. You can also add priorities in every rule to ensure transactions are routed to the best-performing gateway.

Related Information

• Add a Payment Provider
• Dynamic Routing
• Capture and Refund Settings
• Supported Gateways and Aggregators
• SR Analytics Dashboard
• Single Reconciliation View
• Roles and Permissions
• Tokenisation for Optimizer