Knowledge Base

Configuring Viva.com Credentials

All credentials live on the plugin, never the gateway. Open Settings > Plugins > Installed >
Viva.com Payments Manager > Manage
.

Field Auth scheme Used for
Smart Checkout Client ID OAuth2 (Bearer) Creating hosted checkout orders
Smart Checkout Client Secret OAuth2 (Bearer) Creating hosted checkout orders
Merchant ID Basic Recurring charges, refunds, webhook key
API Key Basic Recurring charges, refunds, webhook key
Source Code (optional) ISV / marketplace accounts only
Test (demo) mode Point at Viva's demo environment

Both credential sets are required — Viva uses OAuth2 for the /checkout/v2/* endpoints and legacy
Basic auth for the /api/* endpoints. Secrets are stored encrypted; leave a secret field blank
to keep its current value.

Connection test

Saving runs a live connection test. Success shows "Settings updated and a connection to
Viva.com was verified."
If it can't connect you'll get a notice to re-check the credentials — the
settings still save, but payments won't work until the test passes.

Please rate this article to help us improve our Knowledge Base.

0 0