New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now
Docschargebee docs
HomeBillingCPQPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Payment Methods


  • Payment Methods Overview
  • Cards
  • Direct Debit
  • Bank Based Payments
  • Wallets
  • Vouchers
  • Articles and FAQ

Payment Gateways and Configuration


  • Payment Gateways Overview
  • Chargebee Test Gateway
  • Stripe
  • PayPal Payment Services
  • Chargebee Pay
  • Adyen
  • Authorize.net
  • Bambora (formerly Beanstream)
  • Bank of America
  • BluePay
  • BlueSnap
  • Braintree
  • Checkout.com
  • CyberSource
  • dLocal
  • EBANX
  • Ecentric
  • Elavon
  • E-xact Direct Integration
  • eWay Rapid
  • Global Payments
  • GoCardless
  • J.P. Morgan Mobility Payment Solutions
  • Metrics Global
  • Mollie
  • Moneris
  • Network Merchants Incorporated (NMI)
  • Nuvei
  • Orbital (Chase Paymentech)
  • Pay.com
  • Paymill
  • Paystack
  • Pin Payments
  • QuickBooks Payments
  • Razorpay
    • Razorpay — Domestic & Export
    • Razorpay Import
    • Razorpay Cards
    • Razorpay Netbanking and UPI Processing
    • Razorpay RBI e-Mandate Impacts
  • Sage Pay
  • Solidgate
  • Tempus
  • Twikey
  • Windcave
  • Worldline Online Payments(formerly Ingenico)
  • Worldpay
  • Articles and FAQ

Level 2/3 Data Support


  • Level 2/3 Data Support

Payment Optimization Engine


  • Overview
  • Defaults
  • Advanced Setup
  • Payment Method Display Rules
  • Verification Rules
  • Routing Rules

Dunning


  • Dunning
  • Articles and FAQ

Offline Checkout


  • Offline Checkout
  • Articles and FAQ

Transaction Sync & Invoice Mapping


  • Transaction Sync and Invoice Mapping

Fraud Management


  • Fraud Management

Error Handling


  • Errors with Root Cause and Troubleshooting

Payment Lifecycle Logs


  • Payment Intents
  • Transactions
  • Gateway Activity Logs
  • Gateway Webhook Logs
  • Retries
  • Articles and FAQ

Others


  • Reach (Merchant of Record)
  • Bulk Deletion of Payment Methods
  • Custom Payment Methods
  • Payment Initiator Parameter
  • PSD2 and Strong Customer Authentication
  • RBI e-Mandate
  • RBI Tokenization Regulations
  • Chargeback Management
  • Transaction Descriptors
  • Payment Preferences
  • Visa Trial Rules
  • Mastercard Trial Rules
  • Co-badged Card Compliance
  • Articles and FAQ
  1. Payments
  2. Payment Gateways and Configuration
  3. Razorpay
  4. Razorpay Cards
  1. Payments
  2. Payment Gateways and Configuration
  3. Razorpay
  4. Razorpay Cards

Razorpay Cards

Chargebee supports card payments via Razorpay for one-time and recurring (e-mandate) collection. Customers enter card details at checkout, complete mandatory card verification / 3DS when prompted, and return to Chargebee on success.

Use this page after Razorpay is connected and Cards is enabled.

See also

Before you start

  1. Choose a setup on Razorpay
  2. Connect — Domestic & Export or Import
  3. Enable Cards in Chargebee and Razorpay
  4. Review checkout, recurring limits, and testing on this page

Supported countries and currencies

  • Domestic: Customers in India; presentment INR.
  • Export-enabled Domestic: Customers outside India in Razorpay-supported presentment currencies; settlement remains INR.
  • Import: Customers in India only; presentment INR.

See Supported countries and currencies on the Razorpay overview.

Prerequisites

Before processing card payments via Razorpay:

  • Ensure Razorpay is configured in your Chargebee site (Domestic & Export or Import).
  • Card verification / 3DS is mandatory for Razorpay in Chargebee (cannot be turned off for this gateway).
  • Enable INR (and any Export presentment currencies you need) in Chargebee as applicable.
  • Ensure recurring card / e-mandate permissions are enabled on your Razorpay account where required.
  • For Import, collect a complete shipping address and required customer / card holder fields — see Razorpay Import.

Configure Cards in Chargebee

  1. Connect Razorpay using Domestic & Export or Import.

  2. On the Razorpay gateway in Chargebee, enable Cards — see Enable payment methods.

    Enable Cards and other Razorpay payment methods in Chargebee
  3. Ensure Cards (and recurring card / e-mandate permissions where required) are enabled in Razorpay.

  4. Go to Settings > Configure Chargebee > Currencies. Review your currency settings and add INR (and any Export presentment currencies you need).

    Review currency settings in Chargebee
  5. Review Smart Routing if you route card payments across multiple gateways.

For checkout integration options, see Razorpay — Integration options. For webhooks on Domestic & Export, see Razorpay — Domestic & Export.

Checkout flow (cards)

The following steps describe a typical subscription checkout with card payments:

  1. Review the order details and click Proceed to checkout.

    Your order page with Proceed to checkout
  2. Review the order and continue.

  3. Enter account details (and shipping if collected).

  4. Select Credit Card, enter card details, and continue.

    Add payment method page with Credit Card selected
  5. Review mandate details if prompted.

    Review mandate details for a card e-mandate
  6. Review the order, click Pay, and complete 3DS on the bank page.

    Complete your order page with Pay for a card payment
  7. On success, the customer returns to confirm the purchase.

Note

For Netbanking and UPI checkout, see Razorpay UPI & Netbanking — Checkout flow.

Recurring cards and e-mandates

The following conditions apply when customers use cards via Razorpay:

  • Customers cannot set up recurring payments if the card-issuing bank does not support e-mandates or is not supported by Razorpay. Consider Netbanking or UPI as alternatives. See Razorpay’s supported banks and apps.
  • Because of a Razorpay limitation, customers must add a new payment method on checkout or Pay Now to purchase or set up other subscriptions. Saved Cards (or Netbanking e-mandates) do not appear when the customer clicks Pay Now.
  • Upgrades to an existing subscription via the Chargebee Portal are not supported. Customers must cancel an existing subscription and buy a new one.
  • The e-mandate is set up with these guidelines:
    • The maximum amount is INR 15,000.
    • Validity ends with the card expiry date.
    • Billing frequency is sporadic (as and when presented).

Also see Razorpay RBI e-Mandate Impacts.

Testing

Domestic / Export and Import use different Razorpay test accounts and different test card details. Do not reuse a Domestic test MID for Import (or the reverse).

Test instruments work in test mode only. No real money is moved.

Testing in sandbox (Domestic / Export)

Use your Chargebee test site with a Razorpay Domestic test account.

Cards — Domestic payments

NetworkCard numberCVV / Expiry
Mastercard5267 3181 8797 5449Any CVV / any future expiry
Visa4111 1111 1111 1111Any CVV / any future expiry

Cards — International / Export presentment (when international payments are enabled on the Domestic account)

NetworkCard numberCVV / Expiry
Mastercard5555 5555 5555 4444 or 5105 1051 0510 5100 or 5104 0600 0000 0008Any CVV / any future expiry
Visa4012 8888 8888 1881Any CVV / any future expiry

Full Domestic test card lists (including subscriptions): Razorpay test cards and UPI.

Import card testing

Use a Chargebee test site with Razorpay Import enabled, and a Razorpay Import test account (not your Domestic test MID).

Cards (from Razorpay Import test guide — note the Domestic Visa number differs from the Domestic account list above)

NetworkDomestic / InternationalCard number
MastercardDomestic5267 3181 8797 5449
VisaDomestic4386 2894 0766 0153
MastercardInternational5555 5555 5555 4444, 5105 1051 0510 5100, or 5104 0600 0000 0008
VisaInternational4012 8888 8888 1881

Use any future expiry and any CVV. For other networks, Razorpay publishes BIN start-digit guidance on the Import test page (dummy cards are not available for all networks).

Always include a valid shipping address in Import test checkouts, or the payment can fail validation.

Full Import sandbox guidance: Razorpay — Test Import integration. Also see Razorpay Import.

Related content

  • Razorpay
  • Razorpay — Domestic & Export
  • Razorpay Import
  • Razorpay UPI & Netbanking
  • Razorpay RBI e-Mandate Impacts

Was this article helpful?