PrestaShop

• Categories: Extensions, Payments & Security, Payment Integration
• Platform compatibility: V1.7.0.0 - V9.0
• Module version: V1.3.1

Click the button below to download this plugin and view any related documentation available.

Sandbox credentials

Our PrestaShop requires credentials to our Payments gateway. You can get your Test credentials by registering with our developer portal. Once registration is complete, you can find the required Public and Secret Keys in your account.

Configuration

To configure this plugin, follow these steps.

1. Log in to the Admin panel for PrestaShop.
2. Navigate to Modules > Module Manager.
3. Under the Other tab, locate our module, and click Configure.
4. From here, you can configure the Payments gateway.

Payments settings

The Payments gateway offers payment through credit and debit cards. The Payments Settings tab allows you to enter your overall account credentials.

The following table describes the fields that appear on the Payments Settings tab for PrestaShop.

Use the test card numbers below to verify that your integration was set up properly. For testing, you can use any cardholder name, any expiry date in the future, and any CVN security code.

For a full list of test cards, see our Test Cards article.

Now that you’ve successfully installed the plugin and tested to see if it was installed properly, you’re all set to go live in the Production environment.

To do this, you’ll need to connect your integration with the gateway.

1. Input your Production Public and Secret Key into your gateway configuration in the PrestaShop Admin panel, and enable the Live Mode for the gateway.

This section contains information on payment solutions such as card storage, and order management.

Card Management

All card data is tokenized using our tokenization service.

Registered customers can save their card information by selecting the “Save for later use” checkbox in the checkout form. The PrestaShop plugin securely stores card data with us and receives a token representation of the card, which is stored in the PrestaShop vault, with no increased PCI compliance requirements.

1. The customer can choose from the list of their stored cards.
   
2. Registered customers can see the list of their stored cards under My Account > My Cards. They can also delete their stored cards from here.

Order management

1. Detailed information on transaction outcome is available in the Orders section for PrestaShop.
2. If the payment was successful, the order status will be set to Payment Accepted.

Create an invoice – capture a transaction

Merchants who use “Authorize only” at checkout will authorize the funds on the customer’s card, but the transaction won’t be placed in the settlement file until we capture it.

The amount of time the funds can remain ring-fenced on the customer's card may vary between different Issuers and Acquirers. Card brands like Visa and Mastercard have their own rules around how long transactions can wait to be captured.

1. To view the response returned by us, first open the order and then select Transactions from the left menu. Then, scroll to the bottom of the page to view the response details.
2. If successfully authorized, the funds will be ring-fenced on the customer’s account. When you want to include the transaction in the next settlement file (also known as a batch), you can simply send a Capture (Settle) request. When the transaction is captured with the Acquirer, the funds are deducted from the customer's account and settled into the merchant's account.
3. At this point, if you select the Documents tab, you'll see that there is no invoice associated with the order. This is because we haven't captured it yet.
4. For the request to be sent to us, you must select Capture from the Transaction Management tab.
5. Once complete, the result of the Settle request will be displayed. A comment is included in the Transaction Management History tab.
6. If you select the Documents tab now, you’ll see the invoice associated with the order.

Refund a captured transaction

Once an order has been successfully settled with your Acquirer, you can credit the customer for 0% to 100% of the original order value. To do this, you must create a Partial Refund in PrestaShop.

1. Navigate to Orders, and select the order you want to refund.
2. Click Partial refund. This will send the refund request to us. You can edit the amount to credit by editing the adjustment fields provided by PrestaShop.
   
3. Once complete, you will be returned to the Order page, and a message indicating the outcome of the refund request will display.
4. A comment will be also added to the Transaction Management History tab.

Pay for order

1. For an order created on the admin side with the status Waiting for payment, a new Pay for Order button is displayed.
2. Clicking this button will open a pop-up window where the admin can pay for the total order value using a card or one of the stored cards of the user that the order was set to.