Viva Wallet

Setting Up Viva Wallet for FoxyCart

Viva Wallet can be enabled for your Foxy store from the “payment” page in the Foxy administration. Enable the “Accept payments using your Viva Wallet Smart Checkout account” checkbox on the page. The credentials needed can be accessed by following these steps:

1. Log in to the Viva Wallet administration and select your specific wallet

2. In the left hand menu, select “Settings” > “API Access”

   1. Under “Access Credentials” you'll see the “Merchant ID” and “API Key”. These can be copied into the fields with the same name in the Foxy administration “payment” settings page.

   2. Under “Smart Checkout Credentials” you can also generate the “Client ID” and “Secret ID” needed for the fields of the same name on the Foxy “payment” settings page. Note that the secret will only be shown once so ensure you copy it before proceeding. If needed, a new ID and Secret pair can be generated from the same section.

3. In the left hand menu, select “Sales” > “Online Payments” > “Websites/Apps”

4. Click the “Add Website/App” button on the page

   1. In the panel that appears, a “Code” will be automatically set - which you can leave as is.

   2. Set a “Source Name” (just an internal identifier for your reference) and select a “Linked account” as necessary.

   3. Set the “Protocol” to “HTTPS” and enter your Foxy store subdomain in the “Domain Name” (like mystore.foxycart.com if you're using a Foxy subdomain, or your custom subdomain if you're using one)

   4. For the integration method, select “Redirection/Native Checkout v2”

   5. For the “Success URL”, set it to checkout?fc_status=tx_accepted&ThisAction=hosted_checkout

   6. For the “Failure URL”, set it to checkout?fc_status=tx_cancelled&ThisAction=hosted_checkout

   7. Complete the checkboxes at the bottom of the form and save.

5. Once saved, you can then copy the “Code” for your newly created Website/App as the “Source Code” in the Foxy payment settings.

Create A Webhook

1. After you've saved the Viva Wallet values into the Foxy admin, go back to the “Settings” > “API Access” page in Viva Wallet and go to the “Webhooks” tab. Click the “Create Webhook” link.

   1. In the “URL”, you need to enter your store's IPN URL to be https://YOUR-FOXYCART-STORE-DOMAIN/ipn.php - changing it to match your own FoxyCart store domain. For example, if your FoxyCart store domain was example.foxycart.com, you would set the URL to be https://example.foxycart.com/ipn.php. If it was a custom subdomain like secure.example.com the URL would be https://secure.example.com/ipn.php.

   2. Click the “Verify” link to the right of the URL text input to confirm it is entered correctly.

   3. Check the “Active” checkbox

   4. Set the type to “Transaction Payment Created”

   5. Click the “Save” button.

Testing

Obtaining A Test Account

A test account can be created via the Viva Wallet sandbox system at demo.vivapayments.com

Test Card Numbers

A collection of test cards can be seen on the Viva Wallet documentation here.

Troubleshooting & Interpreting Response Codes

Contact Viva Wallet for info.