Placetopay - Payment Gateway for Shopify

Functionalities

Shopify Installation Guide

This guide explains, step by step, how to install the PlacetoPay plugin for Shopify. Each configuration parameter described here is demonstrated in a test environment to illustrate the setup in detail.

Please follow the steps below:

1. Go to the Shopify / PlacetoPay app page using this URL.

2. Install the app:

   • If you are already logged in, you will see an Install button.
   • If you are not logged in yet, access your Shopify admin with the credentials of the specific store you will integrate.
   
   • The terms and conditions and detailed information about Evertec PlacetoPay will be displayed.
   

3. You will be redirected to the payment gateway settings where you must configure the following:

   Site Identifier and Secret Key

   These two values are provided by PlacetoPay. Enter them exactly as received.

   

   Country or Account Provider

   Select the country or provider used for your commercial relationship.

   

   Session Lifetime

   This is the time window given to the buyer to complete checkout. A period of 10–15 minutes is recommended.

   

   Activate Testing Module

   This option controls the environment used by the plugin. When enabled, test environments are used. To make changes in production, disable this option.

   

   Notification URL

   The default URL provided by the plugin is used to update transactions asynchronously. It’s important to share this URL with the payment gateway so it can be configured properly.

   

   Configure Tax Sending (only if your country is enabled)

   If your country is enabled for tax sending, follow these steps:

   1. In your Shopify admin, go to Settings and add a webhook as shown.

      

   2. Select the values exactly as shown in the image and set the notification URL to: https://plugin-latam.placetopay.com/api/webhooks/shopify/checkouts/update

      

   3. Copy the value shown next (the generated Webhook token) to use it in the plugin form.

      

   4. In the plugin configuration form, enable the Send taxes option to activate tax sending and paste the copied token in the Webhook token field.

      

   Save

   When you finish, click Save configuration to apply the changes.

   

4. After saving the payment method, click Activate PlacetoPay to enable it.

5. After completing the configuration and confirmation, the system will display a screen indicating that the component has been enabled and is ready to use.

Order statuses

When your customer starts the purchase flow, an order is created. Depending on the case, it can transition through the following five statuses:

• Pending payment: Waiting for the buyer to complete the payment. Once paid, the order will automatically move to Completed or Processing depending on the case.
• Completed: The payment was successful.
• Processing: The transaction is under review (applies to one-time payments—cash/transfer—and payments requiring authorization).
• Refunded: The refund was issued and the returned products were restocked.
• Failed: The transaction could not be completed due to insufficient funds or incorrect data.