Shopify
This guide outlines the steps to enable PayU on your Shopify website.
Prerequisites
- An active PayU Latam account.
- A valid Shopify plan. Note that Checkout functionality is not available with trial plans. You can explore Shopify’s plans and pricing here.
Order management in Shopify
Take into account the following provisions when managing orders in Shopify:
- All orders: Includes orders with the following 2 statuses:
- Approved: Orders that are paid in full or partially.
- Pending: Orders waiting to be completed when the customer returns to the store after processing a payment through the gateway.
- Abandoned checkouts: Applies to processes that:
- Remained incomplete because the user could not complete the payment or abandoned the shopping site.
- Are marked as Rejected.
- Remain in a Pending state without the customer returning to the shopping site after payment processing through the gateway, this includes:
3.1. Cash payments.
3.2. Credit card payments that enter validation due to anti-fraud protection rules.
Note
- Shopify DOES NOT reserve inventory for any of the above scenarios.
- For processes considered as abandoned checkout, the system only generates orders once the transaction reaches an Approved status.
Setting up PayU as payment gateway
- Log in to your Shopify account and download the PayU Latam v2 app from the app store by clicking here and selecting Install.
- Select the store where you want to install the app, you’ll be redirected to the installation page, click on Install.
- Choose the desired environment for the app installation—either the Test Environment or the Production Environment. Then, input your Merchant ID and Account ID and select Save to confirm.
Note
- Find your production environment credentials by logging into your PayU administrative module, where you can locate the Merchant ID and Account ID in the top left corner of the module.
- Find the test environment credentials here.
- You can check or change your credentials in your Shopify account settings.
Important
You need an Account ID per store in Shopify.- You will be redirected to the Payments page, to enable the app, click on the Activate button located in the bottom right corner.
Important
- For your information, you’ll see various payment methods. To proceed, you must select at least one of them, this won’t alter the payment methods available in the PayU Web Checkout.
- Test mode: within the same Payments section, you’ll find the option to use test mode, allowing you to conduct tests in the Sandbox environment.
- We recommend that you use the test environment in a controlled manner, preferably during off-peak hours, as transactions processed in test mode do not result in real payments and the production environment remains disabled.
- To disable test mode, uncheck the box:
- Access your PayU Module, navigate to the Settings section, and click on Technical Settings. Enable the option called Control duplicate payments (Validate unique reference) to prevent issues during payment processing.
- From now on, PayU is set up as your payment processor, enabling you to kickstart your sales. With PayU’s Web Checkout, your customers can make purchases using various payment methods including cash, credit cards, and bank transfers, tailored to the country in which you’re conducting business.
Payment flow in Shopify
When you configure PayU as the payment gateway in your platform, your customers can proceed with payments as explained below:
- Your customer selects the desired product or service and adds it to their shopping cart.
- In the shopping cart, your customer proceeds to checkout.
- After providing their information, your customer clicks on Complete order to be redirected to PayU Latam for payment completion.
- Upon reaching our payment gateway, your customer can view the sale description and available payment methods specific to their country.
Note
If you need to issue a full or partial refund, you can manage it directly from your Shopify store admin. For more information, click here.
Last modified
April 25, 2024:
Documentation updates (8d96a15ad)