Common Issues & Fixes

WooCommerce

Transaction Failures

🔍 Issue: Transaction failed due to network issue.

How do I resolve this error?

• Ensure that your PHP version is 8.2 or above, and the PhonePe plugin version is 3.0.4(latest)
• Please verify your credentials in the Developer Settings section.
  • If you see salt_key and salt_index (V1 credentials):
    • These are older keys. Please reach out to the Integration Team to request PG V2 keys.
  • If you see client_id, client_secret, and client_version (V2 credentials):
    • Ensure that the credentials entered on the config page are correct.
    • Make sure there are no extra spaces.
    • The environment must be set to PRODUCTION, as the plugin currently does not support the UAT environment.

🔍 Issue: Transaction failed due to 404 error and Salt keys (V1 credentials) showing on the PhonePe Plugin configuration page despite being onboarded with V2 client credentials.

How do I resolve this error?

Delete the following entry from the database where you host your website (e.g., Hostinger / GoDaddy, etc.) to reset the credentials page:

In the wp_options table, run the command: 

delete from wp_options where option_name=’woocommerce_phonepe_settings’;

Webhook Configuration

🔍 Issue: I want to configure a webhook for WooCommerce.

• Woocommerce plugin in itself will handle the webhook for the merchant’s transactions initiated via the plugin.
• In case the Merchants webHook is not set, please ensure to remove the credentials and save the settings for PhonePe PG, and then again add the credentials and hit save this will retrigger the merchants webhook setup API.
• We have a scheduled cron added in our plugin code that checks for all pending orders status every 1 minute.  And that cron should be available and added in woocommerce tools scheduled actions page. [Please refer below screenshot]

• If this is not showing up most likely the merchant has disabled scheduled jobs and from their end. Ask your developer to enable the same.

Shopify

Troubleshooting URL Mismatches

🔍 Issue: What should I do if I see a “URL Mismatch” error?

The URL Mismatch Error occurs when the payment request originates from a domain or URL that has not been whitelisted on the PhonePe server. For Shopify integrations, both the domain and the myshopify.com store URL must be whitelisted.

How do I resolve these errors?

• Identify the Required URL(s): Determine the exact domain from which your customers will initiate payments. 
• Request Whitelisting:
  • Action: Provide the required, correct domain URL and the myshopify.com store URL to the PhonePe team.
  • Confirmation: Explicitly state that you authorize the team to proceed with whitelisting the URL.
  • Confirm and Re-test: Wait for confirmation from the PhonePe team that the URL has been successfully whitelisted.
  • Once confirmed, re-initiate the payment from the newly whitelisted Shopify URL.

Note:
Mandatory Whitelisting: It is mandatory to initiate payments only from the authorized, whitelisted URL. Otherwise, you will consistently encounter the “URL Mismatch” error.

Missing Install Button or Redirection Issues

🔍 Issue: Install Button is missing or Multiple Redirection to PhonePe after clicking activate.

How do I resolve this error?

To resolve this, log out of your Shopify account and log back in. Then, proceed with Integrating the PhonePe Plugin to the Shopify Store.

Requesting Production Credentials for Shopify

🔍 Issue: I need production credentials to complete the Shopify plugin integration.

The Shopify Plugin Integration does not require credentials. Simply sign in with your registered email or phone number.