Beskrivning
Bitron Viva Payment Gateway lets you accept Visa, Mastercard, and other card payments in your WooCommerce store through Viva (formerly Viva Wallet / Viva Payments). Customers are redirected to Viva’s secure Smart Checkout page to complete their payment, then returned to your store.
This plugin is provided by BitronDev Kft (https://bitron.hu) and is not affiliated with, endorsed by, or sponsored by Viva.com EAD. ”Viva”, ”Viva Wallet” and ”Viva Payments” are trademarks of their respective owners and are referenced here only to describe the payment service this plugin integrates with.
This plugin is developed by BitronDev Kft, an official Viva ISV (Independent Software Vendor) partner. An ISV service fee of 0.3% per transaction is applied on top of the standard Viva processing fees.
How it works
The plugin routes its API calls through a middleware server (viva.bitron.hu) operated by BitronDev Kft, an official Viva ISV partner. The middleware forwards each request to Viva on the merchant’s behalf so the transaction is correctly attributed to the ISV partnership — that is the technical mechanism by which the 0.3% ISV service fee is applied. The middleware handles order creation, payment source setup, recurring payments, and webhook key retrieval.
No card data ever touches your server, nor the middleware — all payment details (card number, CVC, expiry) are entered on Viva’s PCI DSS-compliant Smart Checkout page and stay there.
Features
- Secure payment processing via Viva Wallet Smart Checkout
- Sandbox and production environment support
- WooCommerce Subscriptions support (recurring payments, card changes)
- WooCommerce Checkout Blocks support
- HPOS (High-Performance Order Storage) compatible
- Automatic webhook handling for reliable payment confirmation
- Full and partial refund support from the WooCommerce admin
- One-click payment source setup from the settings page
- ”Pay Now” link in customer emails and on the order admin page for unpaid orders
- Admin metabox on the order screen to check the Viva-side payment state and manually recover orders that never matched back from the webhook
- GDPR data export and one-click disconnect from the BitronDev Kft middleware (right to access and erasure)
Supported currencies
- HUF — Hungarian Forint
- EUR — Euro
ISV fee
This plugin is provided by a Viva Wallet ISV partner. A service fee of 0.3% is automatically deducted from each transaction by Viva Wallet before settlement. This fee is in addition to the standard Viva Wallet processing fees for your merchant account.
External services
This plugin connects to two external services to process payments. By installing and using this plugin, you agree that the following data is transmitted to these services under the conditions described below.
Viva (vivapayments.com / viva.com)
Viva (formerly Viva Wallet / Viva Payments) is the payment processor that handles card transactions. The plugin redirects customers to Viva’s Smart Checkout page where they enter their card details. Card number, CVC, and expiry are entered on Viva’s PCI DSS-compliant servers and never touch your WordPress site nor the middleware.
When data is sent: at checkout, on payment-method change, on subscription renewal, on refund, on webhook verification, and when you click ”Test Connection” or ”Auto-create Source” in the gateway settings.
Data sent to Viva (via the middleware described below):
- Order ID, amount, currency, locale
- Customer’s billing email and full name
- The merchant’s Viva credentials (Merchant ID and API Key) for authentication
- Transaction ID (for refunds and recurring renewals)
Data received from Viva:
- Transaction ID and status
- Card token — a non-reversible identifier used for recurring payments
- Masked card number (e.g. ****1234) and expiry month/year
- Webhook events for payment confirmation
Viva terms and privacy:
- Terms: https://www.viva.com/en-eu/terms-portal
- Privacy notice: https://www.viva.com/en-eu/privacy-notice
BitronDev Kft ISV middleware (viva.bitron.hu)
BitronDev Kft is an official Viva ISV (Independent Software Vendor) partner. Viva applies the 0.3% per-transaction ISV revenue share to transactions that flow through BitronDev Kft’s ISV channel — viva.bitron.hu is the technical implementation of that channel. The plugin therefore does not call Viva directly; it sends each request to the middleware, which forwards it to Viva on the merchant’s behalf and returns Viva’s response.
When data is sent: every time the plugin needs to talk to Viva (see the Viva section above for the list of moments).
Data forwarded through the middleware (request and response): everything listed in the Viva section above.
Data NOT forwarded through the middleware: card number, CVC, or any cardholder-entered data — these only ever exist on Viva’s Smart Checkout page.
The middleware records each forwarded request and Viva’s response for operational logging (troubleshooting, ISV billing reconciliation, abuse prevention). Logs may include the order metadata, customer name and email, transaction IDs, card tokens, and masked card numbers returned by Viva. Logs do NOT contain card numbers, CVC, or any cardholder-entered data.
Middleware terms and privacy: https://viva.bitron.hu/privacy
Privacy Policy
This plugin sends order and merchant data to the BitronDev Kft-operated middleware (viva.bitron.hu) and to Viva (vivapayments.com) to process payments. See the External services section above for the full breakdown of what is sent, when, and to whom.
The following personal data is stored in your WordPress database as order or subscription metadata:
- Viva transaction ID
- Card token (a non-reversible reference issued by Viva, used to charge subscription renewals)
- Masked card number (e.g. ****1234)
- Card expiry month and year
This data is used to display payment-method information to customers and to process recurring subscription payments. It is removed when the associated WooCommerce orders or subscriptions are deleted.
For Viva’s handling of personal data, see https://www.viva.com/en-eu/privacy-notice. For the BitronDev Kft middleware’s privacy notice, see https://viva.bitron.hu/privacy.
Installation
- Upload the plugin files to the
/wp-content/plugins/bitron-viva-paymentdirectory, or install the plugin through the WordPress Plugins screen. - Activate the plugin through the ’Plugins’ screen in WordPress.
- Go to WooCommerce > Settings > Payments > Viva Wallet to configure.
- Enter your Viva Wallet Merchant ID and API Key (both are listed in the Viva Wallet Dashboard under Settings > API Access). On the same screen, enable the permissions for recurring payments and refunds if you plan to use those features.
- Click ”Test Connection” to verify your credentials.
- Click ”Auto-create Source” or enter an existing source code.
- In the ”Webhook Setup” section, copy the webhook URL shown there and create a webhook in your Viva Wallet Dashboard (Settings > API Access > Webhooks) with event type ”Transaction Payment Created” (1796). Without this, the plugin cannot reliably confirm payments when the customer closes the browser before being redirected back.
- Save settings.
- Switch the Environment to ”Production” when you are ready for live payments.
Vanliga frågor
-
Do I need a Viva Wallet account?
-
Yes. You need a Viva Wallet merchant account. Sign up at viva.com.
-
Where do I find my Merchant ID and API Key?
-
Log in to your Viva Wallet Dashboard and go to Settings > API Access — both the Merchant ID and the API Key are listed there.
-
What is the middleware server?
-
The middleware server (
viva.bitron.hu) is the technical channel through which BitronDev Kft, as an official Viva ISV partner, forwards API calls to Viva so that transactions are correctly attributed to the ISV partnership (which is what enables the 0.3% ISV revenue share). All requests are sent over HTTPS. -
What data is sent to the middleware server?
-
The following data is forwarded through the middleware (in both directions): your Merchant ID and API Key (for authentication of the proxied request), site URL, webhook URL, order ID, amount, currency, locale, customer billing email and name, transaction IDs, and the responses returned by Viva (which include card tokens and masked card numbers such as ****1234, but never full card numbers). No cardholder-entered data — card number, CVC, expiry — is ever sent to or through the middleware; these are entered exclusively on Viva’s Smart Checkout page.
-
What is the ISV fee?
-
As a Viva Wallet ISV partner, a service fee of 0.3% per transaction is applied. This is deducted by Viva Wallet from the transaction amount before settlement to your bank account. This fee is separate from and in addition to the standard Viva Wallet processing fees.
-
Does this plugin support recurring payments?
-
Yes, if you have the WooCommerce Subscriptions plugin installed. The gateway supports initial subscription payments, automatic renewals, and card changes.
-
Does this plugin support WooCommerce Checkout Blocks?
-
Yes, the plugin is fully compatible with the block-based checkout introduced in WooCommerce 8.3+.
-
Can I issue refunds?
-
Yes, you can issue full or partial refunds directly from the WooCommerce order screen.
-
Is it PCI compliant?
-
Yes. No card data is stored or processed on your server. All payment details are handled by Viva Wallet’s PCI DSS Level 1 certified infrastructure.
-
How do I set up the webhook?
-
In the gateway settings, the ”Webhook Setup” section shows the exact webhook URL for your site. Copy it, log in to your Viva Wallet Dashboard, go to Settings > API Access > Webhooks, create a new webhook with that URL, select event type ”Transaction Payment Created” (1796), and save. Without a configured webhook the plugin cannot reliably confirm payments — for example when a customer closes the browser before being redirected back to your store.
-
An order stayed pending after the customer paid — what now?
-
Open the order in the WooCommerce admin. The ”Viva Wallet — Payment status” metabox lets you check the Viva-side state of any stored transaction, and (when an order is unpaid) lets you paste a transaction ID from the logs to fetch the details and manually finalize the order. The amount and order code are verified against Viva before the order is marked paid.
-
How do I exercise my GDPR rights?
-
In the gateway settings, the ”GDPR” section provides two actions: ”Download my data” returns a JSON file with everything the BitronDev Kft middleware stores about your site (registration, order mappings, API logs), and ”Disconnect and erase data” permanently removes your site from the middleware. Both actions affect only the middleware — order data in your own WooCommerce database is not touched.
Recensioner
Detta tillägg har inga recensioner.
Bidragsgivare och utvecklare
”Bitron Viva Payment Gateway” är programvara med öppen källkod. Följande personer har bidragit till detta tillägg.
Bidragande personerÖversätt ”Bitron Viva Payment Gateway” till ditt språk.
Intresserad av programutveckling?
Läs programkoden, kika på SVN-filförvaret eller prenumerera på utvecklarloggen via RSS.
Ändringslogg
1.0.1
- Fix refund process bug
1.0.0
- Initial release.