- 1. Build Integration: Install and configure the BigCommerce plugin.
- 2. Test Integration: Test the integration by making a test payment.
- 3. Go-Live Checklist: Check the go-live checklist.
1. Build Integration
Follow the steps given below:1.1 Installation
Follow the steps given below to install the plugin:- Log in to your BigCommerce account.
- Navigate to Apps → Marketplace.
- Click BIGCOMMERCE.COM/APPS and search for Razorpay.
- Click Razorpay and click GET THIS APP.
- Enter the API Key ID generated from the Razorpay Dashboard.
Handy TipsTo go live with the integration and start accepting real payments, generate Live Mode API Keys and replace the test key with the live key in the integration.
- Click Submit.
Handy Tips
- Webhooks are auto-configured when you enter and submit the API key ID during the installation. You can verify if webhooks are enabled on your Razorpay Dashboard.
- The
order.paidandrefund.processedevents are auto-configured. You do not have to configure it on the Razorpay Dashboard.
2. Test Integration
After the integration is complete, a RAZORPAY PAYMENTS button will appear on your web page/app. You need to click the button and make a test transaction to ensure that the integration is working as expected. You can start accepting actual payments from your customers once the test is successful.Supported Payment Methods
After the integration is complete, a Pay button appears on your webpage/app. Click the button and make a test transaction to ensure the integration is working as expected. You can start accepting actual payments from your customers once the test transaction is successful.UPI
You can enter one of the following UPI IDs:success@razorpay: To make the payment successful.failure@razorpay: To fail the payment.
Handy TipsYou can use Test Mode to test UPI payments, and Live Mode for UPI Intent and QR payments.
Cards
You can use the following test cards to test transactions for your integration in Test Mode.Domestic Cards
Use the following test cards for Indian payments:Network | Card Number | CVV & Expiry Date
Visa | 4100 2800 0000 1007 | Use a random CVV and any future date ^^^^^
Mastercard | 5500 6700 0000 1002 |
RuPay | 6527 6589 0000 1005 |
Diners | 3608 280009 1007 |
Amex | 3402 560004 01007 |Error Scenarios
Use these test cards to simulate payment errors. See the complete list of error test cards with detailed scenarios. Check the following lists:International Cards
Use the following test cards to test international payments. Use any valid expiration date in the future in the MM/YY format and any random CVV to create a successful payment.Card Network | Card Number | CVV & Expiry Date
Mastercard | 5555 5555 5555 4444 5105 1051 0510 5100 5104 0600 0000 0008 | Use a random CVV and any future date ^^
Visa | 4012 8888 8888 1881 | Check the list of supported card networks.Wallet
You can select any of the listed wallets. After choosing a wallet, Razorpay will redirect to a mock page where you can make the paymentsuccess or a failure. Since this is Test Mode, we will not redirect you to the wallet login portals.
Check the list of supported wallets.
Verify Payment Status
You can track the payment status from the Dashboard or by polling APIs.- Log in to the Razorpay Dashboard and navigate to Transactions → Payments.
- Check if a
payment_IDhas been generated and note the status. In case of a successful payment, the status is marked ascaptured.
3. Go-live Checklist
Follow these steps before taking the integration live:3.1 Accept Live Payments
Perform an end-to-end simulation of funds flow in the Test Mode. Once confident that the integration is working as expected, switch to the Live Mode and start accepting payments from customers.3.2 Payment Capture
After a payment isauthorized, it is automatically captured and the amount is settled to your account as per the settlement schedule. Know more about Auto-capture payments.