Existing card details will be saved as network tokens irrespective of whether the The Collect Consent from Customers feature is enabled on the Razorpay Dashboard or not, provided consent_to_save_card=1.
The existing card details are saved as network tokens whether the The Collect Consent from Customers feature is enabled on the Razorpay Dashboard or not, provided consent_to_save_card=1.
If the customer does not consent, the card details will not be saved.
Existing cards are cards whose details have been previously saved with Razorpay on Razorpay servers.
Customers can delete their card details by visiting this link and following the on-screen instructions.
Put this as Handy Tips Delete Saved Card Details Customers can delete their card details. [Hyperlink delete saved card details. Check this demo and follow the on-screen instructions.
sing Saved Cardđź”—
Using
you
you as a business are
Changes on checkout UI. Changes on Razorpay Dashboard. Changes in integration code.
hyperlink these to appropriate sections
In this scenario, you should follow the steps given below:
Follow the below integration steps:
New cards are cards that have previously not been saved with Razorpay.
New cards are the cards that are not saved with Razorpay previously.
Scenario 1 - Business Seeks Customer Consent and Allows Card Saving
Business Seeks Customer Consent, Saves Card Details With Razorpay
Business will seek customer consent on their UI and will save card details with Razorpay.
Business Seeks Customer Consent, Saves Card Details with Razorpay Razorpay Seeks Customer Consent on Behalf of Business
Business can Seek Consent from some Customers Only.
Business Seeks Consent from Some Customers Only
Remove the word Scenario 1, 2, 3 from the titles
Card Tokenisation Scenariosđź”—
Card Tokenisation Use Cases
Related Infođź”—
Related Information
According to RBI Guidelines, only card networks can tokenise cards. Also, tokenisation is permitted only after the customer provides explicit consent. In light of these guidelines, the process for card tokenisation will differ on a case-to-case basis.
RBI Guidelines [Heading 2]
According to RBI Guidelines, only card networks can tokenise cards. Tokenisation is permitted only after the customer provides explicit consent. The process for card tokenisation differs on a case-to-case basis.
Feature Request should appear before the RBI Guidelines
Save Customer Card Details as Network Tokens
This should be part of the Custom Web left navigation
as follows:
using the following code:
using Tokensđź”—
Using
Generate API Keys from the Dashboard.
hyperlink Generate API keys
In an online transaction using UPI collect flow, customers enter their virtual payment address (VPA) on the custom Checkout, open their respective UPI apps and complete the payment after successful two-factor authentication. Customers are redirected to your website after successful payment. In this flow, it is likely that the customers enter invalid VPAs or forget their VPAs, which could lead to higher drop-off rates. To overcome this problem, Razorpay enables you to save the VPAs of a customer. The VPAs entered by the customer is stored and secured as tokens in Razorpay. This saves the customer the hassle of entering the VPA again for every transaction. After that, the customers select the saved VPA and complete the payment on subsequent visits.
Replace with: Razorpay enables you to save the VPAs of a customer. The VPAs entered by the customer is stored and secured as tokens in Razorpay. The customers can select the saved VPA and complete the payment on subsequent visits. * This saves the customer the hassle of entering the VPA again for every transaction. * Without Saved VPAs, the customers may enter invalid VPAs or forget their VPAs, which could lead to higher drop-off rates.
on
at
VPAs are saved as tokens
bold this
utilize
use
There might be cases when you have to display the available EMI plans on the Checkout and your site. In such cases, you can use the Razorpay checkout helper methods to fetch the details of the EMI plans and display them on your site. You can use the event ready, as shown below:
To display the available EMI plans at your Custom Checkout on your site, use the Razorpay checkout helper methods to fetch the details of the EMI plans and display them. You can use the event ready, as shown below:
EMI Plans
You can use the following codes to fetch EMI plans at your Custom Checkout and calculate EMIs.
Format of data object and success/error handlers remain the same as before.
Format of Data Object and Success/Error Handlers
Now you can make AJAX requests. Once done, you can emit resume or cancel the event:
After you make AJAX requests, emit resume or cancel the event using this code:
Since the createPayment method must be called synchronously within user-initiated action, the method above doesn't work if the popup blocker is enabled. You can decouple popup opening and payment creation if you need to perform any asynchronous operation, such as sending an AJAX request before starting payment.
The createPayment method must be called synchronously within user-initiated action. Hence, this method doesn't work if the pop-up blocker is enabled. You can decouple pop-up opening and payment creation if you need to perform any asynchronous operation such as sending an AJAX request before starting payment. Check the code below:
This helps as a visual reminder to the customer that the payment is ongoing.
Can we add a screen shot here for the pop-up?
to the forefront
on the screen
Bring a Popup to the Front
Bring Pop-up to Front
Watch Out! You should provide the user's contact number with the country code to check the eligibility.
add this before the code sample
Sample Code [Use Heading 4]
You can see it in action here:
Check an example code below:
Pass the method and provider parameters during Payment Creationđź”—
Pass method and provider Parameters During Payment Creationđź”—
Sample checkout code to collect the authorization transactionđź”—
Sample Checkout Code to Collect Authorisation Transaction
Recurring Payments API documentation.
Recurring Payments API
know more about the Saved Cards feature.
know about Saved Cards feature. Hyperlink Saved Cards
in this case are:
remove
Know more about integrating bank transfer with Custom Checkout.
In continuation
You can now pass the vpa parameter in the upi array as shown below:
In continuation
Know more about Validate VPA and Saved VPA.
Add in continuation to the previous paragraph
Know more about how to verify payment signature.
Add this in continuation of the previous paragraph.
While Razorpay strives to provide a positive payment experience to every customer, they might face payment exceptions such as:
Use Payments Rainy Day kit to overcome payments exceptions such as:
To overcome such exceptions and provide a smooth payment experience to your customers, use the Payments Rainy Day kit.
remove
Integrate the Payments Rainy Day Kitđź”—
Integrate Payments Rainy Day Kit
You can configure payment methods, orders, company logo and select custom colours based on your convenience. This checkout supports all the major browsers (IE 9 and above).
Custom Checkout is an integration provided by Razorpay where you can completely customize the checkout as per your requirements and use it as a white label solution.
You can use Razorpay Custom Checkout to customise the checkout experience as per your requirements and use it as a white label solution.
You can do this by invoking createPayment method:
Add this in continuation to the previous sentence.
Include the script from https://checkout.razorpay.com/v1/razorpay.js instead of serving a copy from your server. This allows the library's new updates and bug fixes to fit your application automatically. We always maintain backward compatibility with our code.
.
colon Add this line in continuation to the previous line.
PCI DSS
PCI-DSS
All payments received on the unregistered websites are failed by Razorpay.
Razorpay fails the payments received on the unregistered websites.
on
at
With Custom Checkout, you can build a checkout form to suit your unique business needs and branding guidelines.
Integrate Razorpay Payment Gateway with your Custom Checkout. You can build a checkout form to suit your unique business needs and branding guidelines.
This error message is displayed if the Webhook is not configured correctly on the Razorpay Dashboard. To fix this error, check the reasons and their solutions:
Cause: This error message is displayed if the Webhook is not configured correctly on the Razorpay Dashboard. Resolution: To fix this error, check the reasons and their solutions as mentioned below:
Note:
Handy Tips Blue color callout
Note:
Handy Tips
Before connecting your account with the Wix platform, you need to set up Webhook on the Razorpay Dashboard. If you do not set up Webhook, there may be connection errors.
Cause: <add the text here>
Resolution: Set up webhooks.
Webhook
use webhooks across
Wix Integration - FAQs
Frequently Asked Questions (FAQs) Left Navigation - FAQs
order.paid refund.processed payment.failed
filled circles for bullets
t is mandatory to set up a webhook secret. Skipping this can lead to errors. The secret can be a combination of letters, numbers and special characters. The secret entered here is used to validate that the webhook is from Razorpay. Do not expose the secret publicly.
filled circles for bullets The secret should be a combination of ...
Watch the short animation below for more details.
Watch the following video to see how to enable webhooks:
Sign up for a Wix Account.
Sign up for a Wix account. [Hyperlink Wix account]
Verify the Signatuređź”—
Verify Signature
list of checkout options available.
list of available checkout options
failed payments
bold
uccessful payment
bold
This integration method provides a default Razorpay Pay with Razorpay button that invokes the Checkout form. The Checkout form options are passed as data attributes inside a <script> tag. You can add any additional, hidden or visible fields to the form, which will be submitted along with the form.
Follow the steps complete Quick Integration:
Follow these steps to complete Quick integration:
List of other integration methods is available here.
Check the list of other integration methods. [Hyperlink other integration methods]
Know more.
Use this hyperlink for [Ionic serve does not support Cordova browser plugins].
Cordova
hyperlink with Cordova's official website. Use this link: https://cordova.apache.org/
Troubleshooting and FAQs Address Verification System Webhooks (Recommended) Error Codes (Recommended) How Payment Gateway Works Payment States Settlements Refunds Accept UPI payments
Do we need all of these? Add links that are relevant for Corpdova integration.
Ionic serve does not support cordova browser plugins, we do not support ionic serve at the moment.
Rephrase this.
This error occurs with Modulesgarden-enabled WHMCS installation. Modulesgarden plugins update system_url from example.com to example.com/, which changes the URL from "example.com/modules/gateways/callback/razorpay.php" to "example.com//modules/gateways/callback/razorpay.php". Due to this, the HTTP POST request stops working. To solve this issue, remove "/" in "/modules/gateways/callback/razorpay.php".
Web Host Manager Complete Solution (WHMCS) Integration - FAQs
WHMCS FAQs [Same changes in the left nav]
. Learn more about how to validate webhooks.
Know about validating webhooks.
Please refer to the test webhooks section for alternatives to localhost.
Know about validating and testing webhooks for alternatives to localhost. [hyperlink to the right section of the article. Hyperlink validating and testing webhooks for alternatives to localhost.
set-up
setup
Learn more about Webhooks setup.
Know more about how to set up webhooks. [Hyperlink set up webhooks]
in the drop down
from the drop-down list
Unzip and upload the contents of the repository to your WHMCS Installation directory, that is the content of module folder from the repository goes in module folder in your WHMCS Installation directory.
Unzip and upload the contents of the repository to your WHMCS Installation directory. That is, the contents of the module folder from the repository goes into the module folder of your WHMCS Installation directory.
version 2.0.1.
hyperlink version 2.0.1
release tagged version 1.0.3.
hyperlink version 1.0.3
Integrate Razorpay With Web Host Manager Complete Solution (WHMCS)
Integrate With WHMCS Website [Same changes to the left navigation]
Generate the API keys from the Razorpay Dashboard by navigating to Settings → API Keys. You can use the Test mode keys for testing and later switch to Live mode keys when going live with the integration.
hyperlink API keys
we support the following versions of WHMCS:
This can be in continuation with the previous paragraph.
Currently
Remove
Click here for more details.
Know more about compilation errors. [Hyperlink compilation errors] Refer: https://razorpay.com/docs/payments/payment-gateway/capacitor-integration/troubleshooting-faqs/
This issue is caused by the new changes introduced in Xcode 12.
This is because of the new changes introduced in Xcode 12.
Navigate to iOS folder in your project and run 'pod update' to update all the pods. If you do not want to update all pods, run 'pod update razorpay-pod'
If you think of a new feature that can add more value or if it should be included in our plugin, please raise a pull request or create a feature request from New Issue → Feature Request on our GitHub repository.
To raise a request for a new feature, go to New Issue → Feature Request on our GitHub repository.
Learn more about Orders.
Know more about Orders. [hyperlink Orders]
dependencies.
This takes to an undefined page, use the right hyperlink
No
add a comma after No
To work around this issue:
To fix the above error message:
recreated:
recreated, use the following code:
cordova
Cordova
erify the Signatuređź”—
Verify Signature
on
in
Know more about UPI Intent and its benefits.
hyperlink UPI Intent and its benefits.
.
colon
The event names are exposed via the constants EVENT_PAYMENT_SUCCESS and EVENT_PAYMENT_ERROR from the Razorpay class. Use the on(String event, Function handler) method on the Razorpay instance to attach event listeners. Attach Event ListenersCopy
Let's bullet these for easy reading
t.
add a colon
t.
add a colon
s.
add a colon
r app's pubspec.yaml
add a colon after the sentence
The error code is available as the code field of the PaymentFailureResponse instance passed to the callback.
add this in continuation to the previous line
.
colon
Method
Use this method
Method
Use this method
Method
Use this method
Method
Use this method
Method
Use this method
Method
Use this method
Meth
Use this method
Metho
Use this method
plugin
Flutter plugin
A complete list of UPI supported apps and their package names is available here.
hyperlink UPI supported apps and their package names
The sample code below will send collect request to gaurav.kumar@exampleupi handle.
Sample Code [Heading 4] The sample code below will send collect request to gaurav.kumar@exampleupi handle:
In this case
In Collect Flow
In the case of
For
The sample code shown below allows the checkout to perform a netbanking transaction for a payment of â‚ą299.35:
Sample Code [Heading 4] The sample code shown below allows the checkout to perform a netbanking transaction for a payment of â‚ą299.35:
In the case of
For
The sample code shown below allows the checkout to accept a card payment of â‚ą299.35:
Sample Code [Heading 4] The sample code shown below allows the checkout to accept a card payment of â‚ą299.35:
In the case of
For
The Razorpay Flutter Custom SDK lets you integrate the supported payment methods on your Flutter app's Checkout form.
You can use the Razorpay Flutter Custom SDK to integrate the supported payment methods on your Flutter app's Checkout form.
The Razorpay WooCommerce plugin is released under the General Public License v2.0 (GPLv2.0). Click here for details about the license. Check the license text in the license file on GitHub.
This needs to be fixed. Talk to me.
Handy Tip
Handy Tips
it worksđź”—
it Works
If you are using WooCommerce with your WordPress site, we have a WooCommerce plugin too!
If you are using WooCommerce with your WordPress site, use the WooCommerce plugin. This should be in continuation to the previous paragraph.
Razorpay Sub-Merchant Onboarding APIs are RESTful. All our responses are returned in JSON. You can use Razorpay APIs in two modes, Test and Live. The API key is different for each mode. To complete the onboarding process for the sub-merchant, check the KYC document requirements. You can try out our APIs on the Razorpay Postman Public Workspace.
Webhooks
hyperlink Webhooks https://razorpay.com/docs/webhooks/
Install via the WordPress Plugin Directoryđź”—
Install Using WordPress Plugin Directoryđź”—
ebsite.
Add a heading 1 as Integration Steps
download the plugin from the WordPress plugin directory or install it manually.
remove.
Click here for details about the license.
remove this line. The word license in the previous line should take the user here: http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
Make the same changes to EasyDigital. I see same issues there as well.
The plugin has been tested using WooCommerce v4.8.
The plugin is tested using WooCommerce v4.8.
You need to make network calls to use this plugin. Ensure you have the php-cURL extension installed to make the required network calls.
Ensure you have the php-cURL extension installed to make the network calls required to use this plugin.
:
remove colon
If you are not using WooCommerce, you can use our native plugin for WordPress.
Add this as Handy Tips
As per Apple's policy, if you are using a subscription model in your iOS app, you must use Apple's in-app purchase APIs. Apple does not allow to redirect out of the app for digital product purchase.
This should be same as iOS FAQ
tOrders.
space issue
The error code is available as the code field of the PaymentFa
Add this in continuation to the previous paragraph.
ExternalWalletResponseđź”—
Use Heading 2
PaymentFailureResponseđź”—
Use Heading 2
PaymentSuccessResponseđź”—
Use Heading 2
Refer to our standard checkout documentation for a complete list of options for the checkout form.
Know about all the options available on checkout form. hyperlink options available on checkout form
Methodđź”—
Use heading 2
Razorpay classđź”—
Razorpay Class
Get Packagesđź”—
heading 2
Learn more about Proguard rules.
Find out more about Proguard rules. <hyperlink Proguard rules>
Add Proguard Rules (Android Only)đź”—
Use Heading 2
.
add a colon
ml
add a colon
1.2 Add the Dependenciesđź”—
Add Dependencies
Following is the latest version of our framework:
Remove this line. Add as Heading 1 List of Razorpay Flutter Standard SDK Versions (Last 5 versions)đź”—
versions
The sub-bullet style is different. We should use filled circles for these bullets.
RazorpayPaymentCompletionProtocolWithDatađź”—
Use Heading 2 for this
RazorpayPaymentCompletionProtocolđź”—
Use Heading 2 for this
For example, the Swift call is:
remove this line
Order is an important step in the payment process.
This should be in continuation to the previous paragraph.
typealias Razorpay = RazorpayCheckout
align this with the bullet
Watch the GIF to see how to add Frameworks, Libraries and Embed Content.
Add a line before this to make this prominent.
-
colon - Not addressed
In this case,
In the Collect Flow,
Given below is the sample code:
Sample Code
In this case, the SDK invokes an intent, which will be handled by the Cred app installed on the iOS device. Follow these steps:
In Intent Flow, the SDK invokes an intent, which is handled by the Cred app installed on the iOS device.
-
colon
.
colon
For example, the sample code below will send a collect request to the gaurav.kumar@exampleupi handle.
Sample Code[Heading 4] The sample code below sends a collect request to the gaurav.kumar@exampleupi handle:
In this case, it will send the collect request to the UPI app for the specified VPA. Add the following code to initiate a UPI collect request.
In Collect Flow, it sends the collect request to the UPI app for the specified VPA. Add the following code to initiate a UPI collect request:
Pass the WKNavigationDelegate actions to the SDKđź”—
Pass WKNavigationDelegate Actions to SDK -This comment is not addressed
at your Server-sideđź”—
in Your Server - This is not addressed
formula:
The formula should be part of the Handy Tips
alternate
alternative
using
Using Should we use the same name for the left navigation or a shorter one as Accept Payments?
Build Integration Test Integration Go Live Checklist
The left navigation is different when these links are clicked. Fix that
Supportđź”—
Goes after integration steps
Add Related Information section
-
colon
OpenCart Extension
Integrate With OpenCart Website
Step 2: Configure OpenCartđź”—
Heading 1
Install the Pluginđź”—
Install Plugin
.
colon
Send the customer_id, and token_id(associated with the saved card) attributes along with cvv in the payment request:
Add this sentence in continuation to the previous paragraph.
-
Use colon
do the following:
remove
The below method fetches the card network for a card. A minimum of 6 digits is required to identify the network.
Add this line in continuation to the previous paragraph.
.
use colon
As per Apple's policy, if you use a subscription model in your iOS app, you must use Apple's in-app purchase APIs. Apple does not redirect out of the app for digital product purchases.
Cause: As per Apple's policy, if you use a subscription model in your iOS app, you must use Apple's in-app purchase APIs. Apple does not redirect out of the app for digital product purchases.
Resolution: Use Apple's in-app purchase APIs.
[Get this checked by Vinita]
A module map is used to define the header files that should be converted into modules and used by your project. Razorpay handles this internally. You are facing this issue because we have assumed that your default Xcode's name is Xcode.app, which might not be the case always. For example, your default Xcode will appear as Xcode9.3. To resolve this issue, insert this script; in the directory that contains Razorpay.framework file and run it from your terminal, and you are good to go!
A module map is used to define the header files that should be converted into modules and used by your project. Razorpay handles this internally.
Cause: By default, the Xcode's name is assumed to be Xcode.app. For example, your default Xcode appears as Xcode9.3.
Resolution: Insert this script in the directory that contains Razorpay.framework file and run it from your terminal.
There are multiple Swift versions available, but unfortunately, Apple does not make all the versions compatible, so we release frameworks compiled in multiple Swift versions. Download the framework that is compatible with your project. If you run into a compatibility issue, ensure that you try both frameworks.
There are multiple Swift versions available, but unfortunately, Apple does not make all the versions compatible, so we release frameworks compiled in multiple Swift versions. * Download the framework that is compatible with your project. * If you run into a compatibility issue, ensure that you try both frameworks.
If you have or do not have bitcode enabled project, you can use our bitcode enabled framework. There will be no issue, and our bitcode enabled framework will work for both cases.
Razorpay's bitcode enabled framework works even if you do not enable bitcode in your project.
Please ensure that Razorpay.framework is present in your project settings in both the Embedded Binaries and Linked Frameworks. Also, set Always Embed Swift Libraries to "yes" in the project settings. It can happen because of the incompatibility between the developed Swift version with Razorpay.framework and the Swift version of your project. We recommend using the framework compiled with the required Swift language from our iOS documentation.
this message only when running the app on a simulator or using a test key to initialize the SDK.
This message shows up only when running the app on a simulator or using a test key to initialize the SDK.
Be rest assured, as you would see
remove
We highly recommend that you always use the latest SDK.
We recommend you to use the latest SDK.