Knowledge Base

Webhooks & Redirect URLs

Two URLs connect Viva back to Blesta. Both are shown in the admin; copy them into your Viva
dashboard.

Webhook URL

The standard Blesta gateway callback (shown on the gateway settings page):

https://your-host/callback/gw/{company_id}/viva_wallet_gateway/

In the Viva dashboard, add that URL and enable these events:

Event ID Effect in Blesta
Transaction Payment Created 1796 Records the payment
Transaction Reversal Created 1797 Records a refund
Transaction Failed 1798 Ignored (no state change)

Viva verifies the URL with a GET handshake; this endpoint answers with the verification Key
automatically. Events are trusted by re-verifying each transaction via the API, not by a
signature, so duplicate or spoofed notifications are ignored.

Success redirect URL

On the Smart Checkout source in your Viva dashboard, set the success (and failure) redirect to:

https://your-host/plugin/viva_wallet_manager/client_main/success/

Viva appends s (orderCode) and t (transactionId); the plugin verifies the payment server-side
before recording it.

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

0 0