Linux 软件免费装

Bitron Viva Payment Gateway

开发者 oaron
更新时间 2026年5月28日 18:35
PHP版本: 8.0 及以上
WordPress版本: 6.9
版权: GPLv2 or later
版权网址: 版权信息

标签

payment woocommerce gateway credit card viva wallet

下载

详情介绍:

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 Supported currencies 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.

安装:

  1. Upload the plugin files to the /wp-content/plugins/bitron-viva-payment directory, or install the plugin through the WordPress Plugins screen.
  2. Activate the plugin through the 'Plugins' screen in WordPress.
  3. Go to WooCommerce > Settings > Payments > Viva Wallet to configure.
  4. 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.
  5. Click "Test Connection" to verify your credentials.
  6. Click "Auto-create Source" or enter an existing source code.
  7. 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.
  8. Save settings.
  9. Switch the Environment to "Production" when you are ready for live payments.

升级注意事项:

1.0.0 Initial release.

常见问题:

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.

更新日志:

1.0.0