Viva Wallet

Setting up Viva Wallet

Get your credentials from Viva Wallet

1. 1

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

2. 2

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

   • Under Access Credentials you'll see the Merchant ID and API Key.

   • Under Smart Checkout Credentials you can generate the Client ID and Secret ID. The secret is only shown once, so copy it before proceeding. If needed, a new ID and secret pair can be generated from the same section.

Create a Website/App in Viva Wallet

1. 1

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

2. 2

   Click Add Website/App.

3. 3

   In the panel that appears, a Code is set automatically — leave it as is.

4. 4

   Set a Source Name, which is just an internal identifier for your reference, and select a Linked account as necessary.

5. 5

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

6. 6

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

7. 7

   For the Success URL, enter checkout?fc_status=tx_accepted&ThisAction=hosted_checkout.

8. 8

   For the Failure URL, enter checkout?fc_status=tx_cancelled&ThisAction=hosted_checkout.

9. 9

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

10. 10

    Once saved, copy the Code for your newly created Website/App.

Enter your credentials in Foxy

1. 1

   Go to the Foxy admin and go to Settings > Payments.

2. 2

   Open or create a payment method set, then click Add payment method + and choose Viva Wallet Smart Checkout.

3. 3

   Under Live setup, enter the values you collected from Viva Wallet into the matching fields: Client Id, Secret Id, Merchant Id and API Key. Paste the Website/App Code into Source code.

4. 4

   This setup only takes effect once Use live credentials is turned on for the payment method set. Until then your store uses the Test setup values.

5. 5

   Optionally turn on Authorize only (no capture) if you want to authorize payments without capturing them immediately.

6. 6

   Click Create, or Save if you're editing an existing entry.

Create a webhook

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

1. 1

   In the URL field, enter your store's IPN URL, which looks like https://YOUR-FOXY-STORE-DOMAIN/ipn.php. If your store domain is example.foxycart.com, the URL is https://example.foxycart.com/ipn.php. If you have a custom subdomain like secure.example.com, the URL is https://secure.example.com/ipn.php.

2. 2

   Click the Verify link to the right of the URL input to confirm it's entered correctly.

3. 3

   Check the Active checkbox.

4. 4

   Set the type to Transaction Payment Created.

5. 5

   Click Save.

Testing

Obtaining a test account

Foxy provides shared test credentials for Viva Wallet, so in most cases you don't need your own Viva demo account to run test transactions. Leave Use live credentials turned off on the payment method set and your store will use Foxy's test values against Viva's demo environment. Test transactions never reach your live Viva account.

If you'd rather test against your own account, you can create one via the Viva Wallet sandbox system at demo.vivapayments.com and enter its credentials under Test setup. A demo account gives you a Viva administration you can log in to, which is useful for checking how transactions look on the gateway side.

Test card numbers

A collection of test cards is available in Viva's documentation.

Troubleshooting & interpreting response codes

Contact Viva Wallet for info.