Back to Top

Guide for Adobe Commerce PhonePe Payment Gateway

Updated 17 September 2024

Magento 2 PhonePe Payment Gateway extension incorporates the PhonePe payment gateway into the Adobe Commerce store.

The extension is used to accept payment from customers for the products they want to purchase. The transactions is carried out on the PhonePe payment gateway.

Rather than accepting payments on the store’s website, this eCommerce payment gateway processes the transactions by redirecting to a 3D Secure payment page.

Thus, it is safe, secure and reliable payment gateway for integration to your store.

Note: The PhonePe payment gateway accepts all currencies. But, the transactions are carried out in INR(Indian Rupee) only.

Searching for an experienced
Magento 2 Company ?
Find out More

Additionally, if you are to looking to add the Sage Pay Payment Gateway to your Magento 2 store, then do check the Magento 2 Sage Pay Payment Gateway.

Features

  • Customers can use this payment gateway to pay for their purchases.
  • Multiple options such as UPI Payment, QR Code, Credit/Debit Card or Net Banking available.
  • Payment is processed on PhonePe’s secure payment gateway rather than the merchant’s website.
  • The payment gateway is fast in nature as well as secure and reliable.
  • The Payment gateway is SISA PCI-DSS Compliant.
  • It has security features like data encryption, FRA capabilities and internal audits.
  • The extension is suitable for businesses of all sizes from small to large enterprises.
  • Admin can process the refund from the backend.
  • It can be used in both Sandbox and Production modes.
  • Extension can be enabled/disabled from the backend.
  • It supports multiple languages.
  • Title of the payment gateway can be edited by Admin.

Installation

The installation of the extension is simple just like other Magento 2 extensions.

#1 Download Module

Firstly, you need to log in to the Webkul Store, go to My Account>My Purchased Products section. Verify, and then download and extract the contents of this zip folder on the system.

#2 Upload Folder

Once the module zip extracts, follow path src>app and then copy the app folder into the Adobe Commerce root directory on the server.

server

#3 Run Commands

Please add the below mentioned repository details to the composer.json file which is located in the Magento installation root directory.

composer file

You can also go through this PhonePe PHP setup guide.

After uploading the module folder, you need to run the following commands in the Adobe Commerce root directory,

composer require --prefer-source phonepe/phonepe-pg-php-sdk
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento indexer:reindex
php bin/magento cache:flush

Multilingual Configuration

For Multilingual support, please navigate to Store>Configuration>General>Locale. Then, select your desired language from the Locale option.

Locale

Thus, in this way, a multilingual configuration can be done.

Language Translation

For Adobe Commerce PhonePe Payment gateway extension translation, navigate to the following path in your system src/app/code/Webkul/PhonePe/i18n.

Open the file named en_US.csv for editing as shown in the below screenshot,

language translation

Now, upload it to the path src/app/code/Webkul/PhonePe/i18n where the installation of Magento 2 is on the server. The module gets translated into the desired language.

The user can edit the CSV like the image below,

csv edit

After editing and translating the CSV file, you need to save the translated file name according to your regional language and country code such as de_DE.CSV.

Followed by uploading the translated file to the same folder from where you have obtained it, Now your module translation is complete.

csv new

API Credentials Generation

Please go through the PhonePe Developer Documentation to check how to generate the API credentials.

Admin Configuration of Magento 2 PhonePe Payment Gateway

After the successfull installation of the extension, the admin has to configure it from the backend.

They will navigate to Dashboard>Store>Configuration>Sales>Payment Methods>Other Payment Methods>PhonePe Payment Method as per the below image,

configuration

They can also navigate to the Configuration settings directly from the sidepanel of the admin dashboard as per below image,

sidepanel

Further, the following options are available for configuration,

  • Enable: A dropdown with Yes or No options to enable or disable the extension.
  • Title: Set the display name or title of the payment method in the storefront.
  • Environment: A dropdown to use the extension either in UAT Sandbox or Production mode.
  • Merchant Id: Field to Input the Merchant Id.
  • Salt Key: Field to input the Salt Key.
  • Salt Index: Field to set the Salt Index.
  • Payment from Applicable Countries: Dropdown to select countries to accept payment from. If All Allowed Countries is selected then payment will be accepted from all the countries that are allowed.
    If Specific Countries is selected then you can select specific countries from the list to accept payment from.
  • Sort Order: Set the Sort order of the payment method.

Customer Flow – Frontend

After successful configuration of the payment gateway, it’ll be available for the customers to use on the storefront.

Now, After adding product to the cart, adding shipping details, they’ll be be able to view and select the PhonePe Payment Method under Reviews & Payments section,

select PhonePe as payment method

After selecting PhonePe and clicking on Place Order, the customers are redirected to the payment gateway.

The gateway is facilitated by PhonePe on a 3D secure site as per the below image,

payment gateway

After selecting the choice of payment mode such as QR Code, UPI ID, Card(Visa, Mastercard, etc.) or Net Banking, click on Pay.

Once the payment is successful, the acknowledgement is displayed. Further, a timer is set as well, after which the customers are redirected back to the merchant website.

payment successfull

Next, after the redirection on the merchant’s website, an Order number is generated, Additonally, an Order confirmation email is sent along with tracking info to the customers.

It is displayed as per the below screenshot,

order number generated

Refund Process

The admin can also provide online refund to the customers who have used the PhonePe payment gateway to pay for their orders.

The amount will be credited back to their source account.

The admin will navigate to Sales>Orders. After which, they’ll select and view the order against which they’ve to provide the refund.

orders list

Now click on View and navigate to Invoices. Select the Invoice and click on View to check the Invoice.

view invoice

After clicking on View, the Invoice will open up as below,

invoice generated

Once the above is done, the admin will tap on Credit Memo and hit the Refund button

phonepe online refund

Please note that online refund option from PhonePe will be visible from the credit memo option in order invoice page.

If a Credit Memo is raised from the main order view page then the following popup will be displayed,

online refund popup

Setup Currency Rate

Prior to using this payment gateway extension, it is mandatory to set the currency rate as per INR. The admin will navigate to Store>Currency Rate to configure the same.

magento 2 phonepe payment gateway currency rate setup

Support

So that is all for the Magento 2 PhonePe payment gateway extension guide.

For any further queries or assistance, you can drop us an email through [email protected]

Furthermore, there is no need to search elsewhere; grab the chance to initiate your projects with the highly accredited Magento 2 development company.

For a personalized touch, engage and hire Magento developers who are focused on delivering exceptional results for your custom e-commerce projects.

Current Product Version - 4.0.0

Supported Framework Version - Magento 2.0.x, 2.1.x, 2.2.x,2.3.x, 2.4.x

. . .

Leave a Comment

Your email address will not be published. Required fields are marked*


Be the first to comment.

Back to Top

Message Sent!

If you have more details or questions, you can reply to the received confirmation email.

Back to Home

Table of Content