-
-
Notifications
You must be signed in to change notification settings - Fork 3
/
Copy pathreadme.txt
154 lines (106 loc) · 6.72 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
=== WooCommerce Victoriabank Payment Gateway ===
Contributors: alexminza
Donate link: https://www.revolut.me/alexminza
Tags: WooCommerce, Moldova, Victoriabank, payment gateway, credit card
Requires at least: 4.8
Tested up to: 6.6.1
Stable tag: trunk
Requires PHP: 7.0
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html
WooCommerce Payment Gateway for Victoriabank
== Description ==
Accept Visa and Mastercard directly on your store with the Victoriabank payment gateway for WooCommerce.
= Features =
* Charge and Authorization card transaction types
* Reverse transactions – partial or complete refunds
* Admin order actions – complete authorized transaction
* Order confirmation email with card transaction details
* Supports WooCommerce [block-based checkout experience](https://woocommerce.com/checkout-blocks/)
* Free to use – [Open-source GPL-3.0 license on GitHub](https://github.com/alexminza/wc-victoriabank)
= Getting Started =
* [Installation Instructions](./installation/)
* [Frequently Asked Questions](./faq/)
== Installation ==
1. Generate the public / private key pair according to the instructions from *Appendix A*, section *"2. Key Generation and transmission"* of the *"e-Commerce Gateway merchant interface (CGI/WWW forms version)"* document received from the bank
2. Configure the plugin Connection Settings by performing one of the following steps:
* **BASIC**: Upload the generated PEM key files and the bank public key
* **ADVANCED**: Copy the PEM key files to the server, securely set up the owner and file system permissions, configure the paths to the files
3. Set the private key password
4. Provide the *Callback URL* to the bank to enable online payment notifications
5. Enable *Test* and *Debug* modes in the plugin settings
6. Perform all the tests described in *Appendix B*, section *"Test Cases"* of the document received from the bank:
* **Test case No 1**: Set *Transaction type* to *Charge*, create a new order and pay with a test card
* **Test case No 2**: Set *Transaction type* to *Authorization*, create a new order and pay with a test card, afterwards perform a full order refund
* **Test case No 3**: Set *Transaction type* to *Charge*, create a new order and pay with a test card, afterwards perform a full order refund
7. Disable *Test* and *Debug* modes when ready to accept live payments
== Frequently Asked Questions ==
= How can I configure the plugin settings? =
Use the *WooCommerce > Settings > Payments > Victoriabank* screen to configure the plugin.
= Where can I get the Merchant Data and Connection Settings? =
The merchant data and connection settings are provided by Victoriabank. This data is used by the plugin to connect to the Victoriabank payment gateway and process the card transactions. Please see [https://www.victoriabank.md/en/carduri-pj/e-commerce](https://www.victoriabank.md/en/carduri-pj/e-commerce) and contact [Card.Acceptare@vb.md](mailto:Card.Acceptare@vb.md) for details.
= What store settings are supported? =
Victoriabank currently supports transactions in MDL (Moldovan Leu), EUR (Euro) and USD (United States Dollar).
= What is the difference between transaction types? =
* **Charge** submits all transactions for settlement.
* **Authorization** simply authorizes the order total for capture later. Use the *Complete transaction* order action to settle the previously authorized transaction.
= Why the last four digits of the card number are not received from the bank? =
Make sure Victoriabank has properly set up the *Callback URL* in the payment gateway terminal settings. See [Installation Instructions](./installation/) for more details.
To verify the exact response data received from the bank payment gateway - enable *Debug mode* logging in the plugin settings.
= How can I manually process a bank transaction response callback data message received by email from the bank? =
As part of the backup procedure Victoriabank payment gateway sends a duplicate copy of the transaction responses to a specially designated merchant email address specified during initial setup.
If the automated response payment notification callback failed the shop administrator can manually process the transaction response message received from the bank.
Go to the payment gateway settings screen *Payment Notification* section and click *Advanced*, paste the bank transaction response data as received in the email and click *Process*.
= How can I contribute to the plugin? =
If you're a developer and you have some ideas to improve the plugin or to solve a bug, feel free to raise an issue or submit a pull request in the [Github repository for the plugin](https://github.com/alexminza/wc-victoriabank).
You can also contribute to the plugin by translating it. Simply visit [translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/wc-victoriabank) to get started.
== Screenshots ==
1. Plugin settings
2. Merchant data
3. Connection settings
4. Advanced connection settings
5. Refunds
6. Order actions
== Changelog ==
See [wc-victoriabank project releases on GitHub](https://github.com/alexminza/wc-victoriabank/releases) for details.
= 1.4.0 =
Added support for WooCommerce [Cart and Checkout Blocks](https://woocommerce.com/document/cart-checkout-blocks-status/).
= 1.3.8 =
Added support for WooCommerce [High-Performance Order Storage (HPOS)](https://woocommerce.com/document/high-performance-order-storage/).
= 1.3.7 =
Updated Tested up to 6.2.2 and WC tested up to 7.7.2
= 1.3.6 =
Added *No logo* option for payment method at checkout
= 1.3.5 =
Updated Tested up to 6.1 and WC tested up to 7.1.0
= 1.3.4 =
Updated Tested up to 5.8.1 and WC tested up to 5.7.1
= 1.3.3 =
Modified Victoriabank payment gateway URL for 3DS v2 compliance
= 1.3.2 =
Updated Tested up to 5.6 and WC tested up to 4.8.0
= 1.3 =
Added manual processing of bank transaction response callback data
= 1.2.2 =
Added support for EUR and USD currencies
= 1.2 =
Added Test mode option – use Victoriabank test payment gateway during development and integration tests
= 1.1.1 =
Minor improvements
= 1.1 =
* Simplified payment gateway setup
* Added key files upload
* Added payment method logo image selection
* Added validations for keys and settings
* Fixed email order meta fields error
= 1.0.1 =
* Added total refunds via payment gateway calculation (since WooCommerce 3.4)
* Improved logging and unsupported store settings diagnostics
* Check WooCommerce is active during plugin initialization
= 1.0 =
Initial release
== Upgrade Notice ==
= 1.4.0 =
Added support for WooCommerce [Cart and Checkout Blocks](https://woocommerce.com/document/cart-checkout-blocks-status/).
= 1.3.8 =
Added support for WooCommerce [High-Performance Order Storage (HPOS)](https://woocommerce.com/document/high-performance-order-storage/).