Description
VakıfBank Sanal POS for WooCommerce connects your store to the VakıfBank Standard API (integration guide v1.4).
Features
- 3D Secure payments (enrollment, ACS verification, 3DS-method authorization). Half-secure transactions are never processed.
- Sale and pre-authorization, with capture and cancel from the order screen.
- Cancel and refund (full or partial) through the standard WooCommerce refund button. Same-day full refunds are sent as a cancel, as the bank recommends.
- Installments with configurable counts and minimum installment amount. Each product can follow the general settings, offer its own installment counts (for example 3, 6 and 9) or allow a single payment only.
- A declined payment shows the bank’s own response (result detail and code) to the customer.
- Every approved payment is verified at the bank with the Search service. Lost responses are reconciled automatically.
- Settlement totals and detailed settlement list, transaction query, connection test and server IP helper.
- WooCommerce Cart & Checkout Blocks and High-Performance Order Storage (HPOS) compatible.
- The whole admin area and the checkout follow the WordPress language.
Security
- The card number is only used for the 3D Secure enrollment call; it is never stored or logged.
- The security code (CVV) is kept encrypted for a few minutes only, to be sent with the authorization after 3D Secure, and is deleted right after use. It is never logged.
- Merchant password is stored encrypted and is never written to logs.
- One-time, short-lived return tokens, order-key and nonce checks, hash verification of the bank response, rate limiting and an ACS host allow-list.
External services
This plugin sends payment data to the VakıfBank payment services. It cannot work without them.
VakıfBank Standard API (3D Secure and POS services)
- What it is: the card payment gateway of T. Vakıflar Bankası T.A.O. (VakıfBank).
- What is sent and when: when a customer pays, the card number, expiry date, security code (CVV), order amount, currency, order number and the customer’s IP address are sent over HTTPS to the bank to start the 3D Secure verification and to authorize the payment. Merchant number, terminal number and merchant password are sent with each request. Capture, cancel, refund, query and settlement requests (from the order screen and the Tools tab, and an hourly check of unconfirmed orders) send the transaction reference and merchant credentials.
- Customer verification: the customer’s browser is redirected to the card issuer’s 3D Secure page (ACS) hosted by the issuing bank, and returns to the store.
- Hosts:
https://inbound.apigateway.vakifbank.com.tr:8443andhttps://apigw.vakifbank.com.tr:8443(live);https://inbound.apigatewaytest.vakifbank.com.tr:8443(test environment). - Terms and privacy: https://www.vakifbank.com.tr/tr/bankamiz/hakkimizda/gizlilik-kosullari-ve-kisisel-verilerin-korunmasi (VakıfBank privacy terms and personal data protection; card data processing is also governed by the merchant agreement with the bank.)
ipify (server IP detection, optional)
- What it is: api.ipify.org, a public service that returns the public IP address it sees for a request.
- What is sent and when: only when an administrator clicks the “Detect public IP address” button on the Tools tab of the plugin settings. The request is sent from your server; no store, customer or payment data is included. It is never called automatically or on the storefront. The IP is shown so you can ask the bank to allow it.
- Service provider: ipify (Randall Degges). Terms of service: https://geo.ipify.org/terms-of-service ; Privacy policy: https://geo.ipify.org/privacy-policy
Installation
- Upload the
vakifbank-sanal-pos-for-woocommercefolder to/wp-content/plugins/or install the.zipfrom Plugins > Add New > Upload Plugin. - Activate the plugin (WooCommerce must be active).
- Go to WooCommerce > VakıfBank Sanal POS, enter the merchant number, terminal number and password from the bank, and enable the payment method.
- Ask your VakıfBank contact to allow your server IP address (Tools tab shows it) and to enable 3D Secure, pre-authorization and installments if you need them.
FAQ
-
Which currencies are supported?
-
TRY, USD, EUR, GBP and JPY.
-
Does my site need HTTPS?
-
Yes for the live environment. The bank requires public HTTPS return URLs (no localhost or IP addresses).
-
Where do I find the test card numbers?
-
On the Tools tab of the settings page.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“VakıfBank Sanal POS for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “VakıfBank Sanal POS for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.1.0
- The card payment page now opens as a separate full page outside the theme, with the order summary (products, totals) next to the card form and a checkout step indicator. On phones the summary is collapsed above the form.
- Redesigned card payment page: order summary, card brand badge, installment cards with a sticky pay button, clear explanation that no CVV is needed, trust row and a link to choose another payment method.
- Clearer result messages: a declined or cancelled payment shows an error panel on the card page; a payment that is still being verified is shown as information instead of an error.
- Redesigned 3D Secure redirect page with a progress indicator and a manual “Continue” button if the browser blocks the automatic redirect.
- Payment method box at checkout (classic and Blocks) now lists the security points and the installment hint.
- Settings page: setup checklist with a progress bar, a warning when WP_HTTP_BLOCK_EXTERNAL blocks the bank hosts, redesigned order box.
- Test environment: administrators can fill the official test cards with one click.
- Asset files use a modification-time version so browsers never serve stale styles after an update.
- Turkish translation extended for all new texts.
1.0.0
- First release.
