Shopify Integration


Shopify provides a simple, user friendly platform for managing your online store. You can easily integrate the PhonePe Payment Gateway, even without a technical background, by simply installing our official plugin. This straightforward, no code process allows you to start accepting payments and managing orders effortlessly.

⚠️ Admins Only!


Only users with Admin access can set up and integrate PhonePe Payment Gateway.

  • In your Shopify Admin, go to Settings → Payments and click “Add payment method”.
  • Click “Search by provider”, type “PhonePe PG”, and click “Install”.
  • Click “Install” again. This will redirect you to the PhonePe Business Dashboard for authentication.
  • You will be redirected to the PhonePe Business Dashboard. Authenticate using your registered phone number or email and the OTP.
  • Upon successful login, the system will confirm your Shopify store is linked to your PhonePe Merchant ID.
  • After linking, you will be automatically redirected back to your Shopify Admin Dashboard.
  • Click the “Activate” button to enable the gateway.
  • Test Mode (Optional): If you want to test the flow without processing real money, you can enable “Test Mode”.

To ensure everything is working correctly, perform a test checkout:

  • Go to your store, add an item to the cart, and click “Checkout”.
  • On the checkout page, select PhonePe and click “Pay Now”.
  • You will be redirected to the secure PhonePe page to complete the payment.


Congratulations! You have successfully installed and activated the PhonePe Payment Gateway. Your Shopify store is now equipped with a secure, high-speed checkout experience for your customers.

Ready to go live? Double-check that Test Mode is turned OFF to begin accepting payments from your customers!

Previously, transactions only displayed a Payment ID. We have now introduced a new section called Information from Payment Gateway to give you better visibility. Now, for successful payments, Shopify Store Admin users can view the Network Transaction ID for easier tracking, and for failed payments, you can view specific error codes to quickly troubleshoot the issue.

Note: The Network Transaction ID is only generated for successful transactions and is visible to Shopify store Admins users.

When integrating the plugin, it is essential to handle both successful and failed transactions gracefully. To simplify troubleshooting, the PhonePe Payment Gateway now helps you easily identify and understand transaction failures. The table below outlines and explains the specific Shopify error codes you may encounter.

Shopify Error CodeDescription
AUTHENTICATION_FAILED3D Secure or other authentication failed
CARD_DECLINEDGeneric card decline
EXPIRED_CARDCard has expired
INCORRECT_ADDRESSBilling address mismatch
INCORRECT_CVCCVV/CVC mismatch
INCORRECT_NUMBERCard number is incorrect
INCORRECT_PINPIN is incorrect
INCORRECT_ZIPPostal code mismatch
INVALID_CVCCVV/CVC format is invalid
INVALID_EXPIRY_DATEExpiry date is invalid
INVALID_NUMBERCard number format is invalid
PROCESSING_ERRORGeneric processing error (fallback)
RISKYTransaction flagged as risky/fraudulent
CONFIRMATION_REJECTEDPayment confirmation was rejected
Is this article helpful?