---- dataentry gateway ----
type               : gateway # do not change this line
name               : WigWag (powered by Stitch)
countries          : za
support-added      : 2.0
support-removed    : 
auth-net-emulation : no # enter "yes" or "no" (without quotes)
supports-3dsecure  : yes # enter "yes" or "no" (without quotes)
gateway_url        : https://www.wigwag.me/
----



====== WigWag: Payments for South African Merchants ======
===== Setting Up WigWag for FoxyCart =====

To use WigWag in either Test or Production, you’ll need a WigWag Account. 

Sign up for a [[https://just.wigwag.me/signup|WigWag Account.]]

<WRAP center round info 90%>
**Planning to sell subscriptions?** If so, you will need to contact the WigWag support team and request their "Card Consent" functionality be enabled for your account. Also take note of the [[#important_notes_and_caveats|Important Notes and Caveats section]] for subscription related information.
</WRAP>


Once your account is created you can use your Test Credentials with Foxy Test Mode while you configure your store and website.

You can find your WigWag Test Credentials by clicking through to the Account page on the WigWag dashboard.

{{:gateways:1.png?direct&600|}}

\\

Currently WigWag enables payments only in ZAR. To configure Foxy to ZAR:
  - Open the Foxy admin page
  - Go to the Template Sets section
  - Select "English locale for South Africa (Currency: ZAR: R)" as the locale for each template set that you will be using WigWag for
  - Save the changes to your template set

\\

{{:gateways:2.png?direct&600|}}

\\

{{:gateways:3.png?direct&600|}}

===== Production =====

To enable live payments on WigWag you will need to verify your account. Completing verification will take under 15 minutes and consists of sharing a few key documents with WigWag. 

You will also need to start a paid subscription for your Foxy store if you haven't already, which you can do from the dashboard of the Foxy administration.

Once you have a paid Foxy subscription and a verified WigWag account, you can configure live payments in Foxy with these steps:

  - Navigate to the "payments" section of the Foxy admin
  - Select "Live Servers" for the type of payment servers to use
  - If it is selected, uncheck the “Let customers pay with a Credit or Debit Card” checkbox
  - Copy your Live Credentials from your WigWag Dashboard
  - Back in the Foxy admin payments page scroll down to the "Accept payments using your WigWag account" option and enable it if it isn't already
  - Paste the Live Credentials in the appropriate fields
  - Save the changes by clicking the “Update Payment Gateway” button

==== Obtaining a Test Account ====
Contact wigwag for info. <wrap help>Know more? Feel free to edit this page with info.</wrap>
==== Test Card Numbers ====
Contact wigwag for info. <wrap help>Know more? Feel free to edit this page with info.</wrap>



===== Troubleshooting & Interpreting Response Codes =====
Contact wigwag for info. <wrap help>Know more? Feel free to edit this page with info.</wrap>



===== Important Notes and Caveats =====

==== Subscriptions and WigWag ====

If you plan to sell subscriptions through your Foxy store, you will need to have "Card Consent" functionality enabled in your WigWag account. You will need to contact their support to request that be enabled on your account before subscriptions will work on your Foxy store.

=== $0 Subscription Support ===

If you are planning to sell subscriptions, it's important to note that Wigwag are not currently able to support $0 payment requests through their card-consent API that Foxy users for subscription payments. This means that while you can utilise Foxy's subscription functionality through Wigwag, it does not currently support future-dated subscriptions, or subscription modifications (where the order total for today would be $0).

==== Redirect URL ====

To ensure that Foxy is able to redirect the user to the WigWag hosted payment page, you will need to add your Foxy checkout domain as a redirect URL within your WigWag account.

The redirect URL you will need to enter will look like ''https://mystore.foxycart.com/checkout'', replacing the ''mystore'' with your own store subdomain. If you're using a custom store subdomain, your URL will look like ''https://secure.mydomain.com/checkout'', replacing the ''secure.mydomain.com'' portion with your chosen custom subdomain.

To add a redirect URL: 

  - Open your WigWag dashboard and go to the Account page
  - Scroll down to the Add Redirect URLs section under API Details
  - Add the URL for your store's checkout as detailed above and click the “+” to save.

\\

{{:gateways:4.png?direct&600|}}
===== User Notes and Experiences =====
<wrap tip>If you have tips, experience, or helpful notes related to this gateway that would benefit others, please add them below, including your name and the date.</wrap> We reserve the right to edit or remove comments that don't add value to this page.