WP Companion

Getting started

Scotiabank Payment Gateway getting started guide

From prerequisites to your first live transaction. Work through this in order and you will not hit the two problems that stall most integrations.

Prerequisites

The plugin requires you to have signed up for the Scotiabank eCom+ service. We help merchants navigate that signup process so it goes smoothly. If you do not yet have access, we can put you in touch with the right people at the bank for your country.

Once you are signed up, Scotiabank issues you a Store ID and a Shared Secret. Those two values are what the plugin uses to talk to the gateway.

You do not need to wait for the bank before you start. Testing credentials are available so you can prove the plugin works on your store while your merchant application is still in progress. Ask us and we will send them over.

Installation

From the WordPress plugin repository

The quickest route. In your WordPress admin, go to Plugins, then Add New. Search for "Scotia" and the Scotiabank Payment Gateway for WooCommerce plugin appears near the top of the results. Click Install Now, then Activate.

The repository version is the free build, which runs sandbox transactions only. Use it to test. When you are ready to accept real payments, move to a paid plan.

From our website

01 Go to the plugin page and choose your plan.
02 Complete checkout and download the plugin file that is emailed to you.
03 In WordPress, go to Plugins, then Add New Plugin, then Upload Plugin.
04 Select the file, click Install Now, then Activate.

Testing in sandbox

Once the plugin is installed, enter either the sandbox credentials Scotiabank issued you or the testing credentials we provide, then set your store currency to USD for the test.

Run a transaction using any of these test card numbers, with any future expiry date and any CVV.

5204 7400 0000 2745 4004 4300 0000 0007 5426 0640 0042 4979 4147 4630 1111 0059

Test a full approval, a 3D Secure challenge and a refund before you go live. Sandbox mode has no time limit, so there is no reason to rush this step.

Adding Scotiabank's required information to transaction emails

Scotiabank will only approve your account for live card acceptance once your store's transaction emails carry the information the bank requires. This catches out a lot of merchants at the final hurdle, so handle it before you request live credentials rather than after.

We provide a code snippet that adds the required details to WooCommerce's default email templates. It goes into your theme's functions.php file or, better, a code snippets plugin so it survives theme updates.

Going live

01 Confirm Scotiabank has approved your account for live transactions.
02 Replace the sandbox Store ID and Shared Secret with your live values.
03 Switch the plugin out of test mode.
04 Place one small real transaction with your own card.
05 Confirm it appears in Merchant Admin and settles into your account.
06 Refund that transaction to confirm refunds work from WooCommerce.

If the last step fails, the Scotiabank API is most likely not yet enabled on your account. That is a bank-side permission and one phone call usually resolves it.

Stuck on any of these steps?

Professional and Premium plans include implementation and testing support. We answer from Trinidad, in your time zone.