-
Notifications
You must be signed in to change notification settings - Fork 19
/
Copy pathreadme.txt
468 lines (350 loc) · 16.7 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
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
=== Midtrans-WooCommerce ===
Contributors: yocki, rizdaprasetya
Tags: midtrans, snap, payment, payment-gateway, credit-card, commerce, e-commerce, woocommerce, veritrans
Requires at least: 3.9.1
Tested up to: 6.6.1
Stable tag: 2.32.3
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Midtrans-WooCommerce is plugin for Midtrans, Indonesian Payment Gateway. Brings safety and highly dedicated to customer experience (UX) to WooCommerce
== Description ==
This plugin will allow secure online payment on your WooCommerce store, without your customer ever need to leave your WooCommerce store!
Midtrans-WooCommerce is official plugin from [Midtrans](https://midtrans.com). Midtrans is an online payment gateway. We strive to make payments simple & secure for both the merchant and customers. Support various online payment channel. Support WooCommerce v3 & v2.
Please follow [this step by step guide](https://docs.midtrans.com/en/snap/with-plugins?id=wordpress-woocommerce) for complete configuration. If you have any feedback or request, please [do let us know here](https://docs.midtrans.com/en/snap/with-plugins?id=feedback-and-request).
Payment Method Feature:
* Credit card fullpayment and other payment methods.
* E-wallet, Bank transfer, internet banking for various banks
* Credit card Online & offline installment payment.
* Credit card BIN, bank transfer, and other channel promo payment.
* Credit card MIGS acquiring channel.
* Custom expiry.
* Two-click & One-click feature.
* Midtrans Snap all supported payment method.
* Optional: Separated specific payment buttons with its own icons.
== Installation ==
1. Upload the plugin files to the `wp-content/plugins/midtrans-woocommerce` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the `Plugins` screen in WordPress
3. Go to **WooCommerce - Settings - Payments - Midtrans** menu, fill the configuration fields.
### Midtrans MAP Configuration
1. Login to Midtrans MAP Dashboard.
2. Select the environment (sandbox or production).
3. Go to **settings - configuration**
- Insert `[YourWebHomepageUrl]/?wc-api=WC_Gateway_Midtrans` as your Payment Notification URL
- Insert `[YourWebHomepageUrl]/?wc-api=WC_Gateway_Midtrans` as your Finish, Pending and Error Redirect URL
== Frequently Asked Questions ==
= Where can find my access key (client & server key)? How to get Started? =
Register first to [Midtrans](https://account.midtrans.com/register), you will get the access key on Midtrans Dashboard.
Also please refere to this official [documentation](https://docs.midtrans.com/en/snap/with-plugins?id=wordpress-woocommerce).
= How to configure installment and other additional feature ? =
Please refer to [Wiki](https://github.com/veritrans/SNAP-Woocommerce/wiki) for full documentation and tutorial.
= Where can I report bugs and request feature? =
The best way please email to [email protected], but bugs can be reported in our [repo](https://github.com/veritrans/SNAP-Woocommerce/issues), or you can also use WordPress plugins support for reporting bugs and error.
== Screenshots ==
1. Payment displayed as popup, your customer no need to leave your store!
2. Various payment channel
3. Support for additional feature like installment & promo.
4. Configuration page
== Changelog ==
= 2.32.3 - 2024-08-15 =
* add identifier to handle webhook, get transaction status, and refund using Dana
* bump tested compatibility with current latest version of WordPress & WooCommerce (php 8.2, WP version 6.6, WooCommerce 9.1.2)
= 2.32.2 - 2023-01-02 =
* prevent issue of Midtrans payment webhook notification of refund status causing unexpected error on WooCommerce
* bump tested compatibility with current latest version of WordPress & WooCommerce
= 2.32.1 - 2021-02-08 =
* minor plugin size reduction by removing unused assets
* update payment icon logo for brimo & dandan with current version
= 2.32.0 - 2021-09-22 =
* improve payment icon visual: add semi transparet background & border for better compatibility with dark color theme, prevent image stretched on some themes, add spacing
* improve notif handler to allow retry of 'expire' card payment (abandoned on 3DS step)
* add WP filter hook 'midtrans_gateway_icon_before_render' modify payment icons HTML image tag
= 2.31.1 - 2021-09-01 =
* improve compatibility with external optimizer plugins on payment page JS (remove jQuery dependency)
= 2.31.0 - 2021-08-26 =
* handle duplicated Snap order_id (incase WP is reinstalled, or DB restored) by auto-adding suffix
* improvement on finish url redirect flow, to prevent issue
* handle uncaught error on finish url
* immediate-reduce-stock disabled by default
* emmit custom headers & metadata on http request
= 2.30.1 - 2021-08-09 =
* prevent issue "cannot inherit abstract function" on outdated PHP v5.0.0 - v5.3.8 & v7.0.0 - v7.1.x
* minor description improvement
* add config to allow [Customize WooCommerce Order Status upon Payment Paid ](https://docs.midtrans.com/en/snap/with-plugins?id=advanced-customize-woocommerce-order-status-upon-payment-paid)
= 2.30.0 - 2021-08-06 =
* major feature: sub [specific gateway buttons for each](https://docs.midtrans.com/en/snap/with-plugins?id=advanced-specific-payment-buttons) supported payment methods
* improve config page UI section separation
* add notif url config value recommendation on config page UI
* immediate-reduce-stock enabled by default
* improve gateway payment button naming
* add config field to allow customize payment button icons
* add built in payment icon assets
* improve UI, messaging clarity, and order of advanced config
* added some custom [wp hooks](https://github.com/veritrans/SNAP-Woocommerce/#available-custom-hooks)
= 2.22.0 - 2021-04-27 =
* prevent issue of 3rd party Cloudflare plugin breaking payment page (reload repetitively)
* improve configuration page structure and description
* enhance "ignore pending status" config
= 2.21.0 - 2021-03-08 =
* improve compatibility: prepare future WP >5.7 CSP on js script tag
* minor payment page js enhancement
= 2.20.0 - 2021-03-03 =
* ensure compatibility with WP 5.7
* better compatibility: prevent conflict with other plugins with Midtrans library
* remove jquery dependency
* minor formatting and description improvement on payment page
= 2.19.0 - 2020-08-19 =
* fix library incomplete update
* bugfix save card feature
* bugfix promo feature
* better compatibility: prevent conflict of function & vars with other plugins
* updated plugin descriptions
* performance improvement on handling debit finish page
= 2.18.5 - 2020-08-14 =
* update versioning & compatibility
* input processing improvements
= 2.18.4 - 2020-06-25 =
* add acquring_bank field on credit card full payment (main payment)
* fix logic code on midtrans logger
= 2.18.3 - 2020-05-13 =
* hide 3ds and save card configuration field on midtrans subscription admin and make it active
* add plugin action links
* fix typo on description plugin detail
* improve get_environment method
* add wiki link on subscription method description
* update handling notif when order id not exist on WC dashboard
* change payment option name `Midtrans Credit Card Direct`
= 2.18.2 – 2020-04-30 =
* hot fix remove deprecated method
= 2.18.1 – 2020-04-27 =
* fix handling notif if wc_subscription not installed skip the validateSubscriptionTransaction()
= 2.18.0 – 2020-04-23 =
* add midtrans subscription method for Woocommerce Subscriptions
= 2.17.2 – 2020-04-08 =
* clean up code
* add more descriptive wording on description default value
* fix code to prevent the notif_handler class being called multiple times
* improve method setLogRequest
* add cancel transaction method
= 2.17.1 – 2020-04-06 =
* Fix code for backward compatibility php 5.6
= 2.17.0 – 2020-03-26 =
* Add Logging option on admin settings
* Refactoring code
* Tweak fullpayment payment method enabled by default
* Replace deprecated methods
= 2.16.0 =
* Replace veritrans with midtrans php lib
* Add refund method
= 2.15.0 =
* Enhance Snap API error message display
* Tested compatibility to WP v5.3
= 2.14.0 =
* Enhance finish page for BCA Klikpay
= 2.13.0 =
* Output optimization
* Add config to prevent redirect & ignore on `pending` status
= 2.12.0 =
* Updated API library to ensure smooth API connection
= 2.11.0 =
* UX improvement for pending payment
= 2.10.0 =
* Code cleanup
= 2.9.0 =
* Replace order notes to order metadata
= 2.8.0 =
* Removed separate MIGS button for installment & fullpayment
* Installment terms for online installment now configurable
* Installment banks for online installment now configurable
* Installment terms for offline installment now configurable
* Installment bank for online installment now configurable
= 2.7.0 =
* Add payment url link on order view
* Improve deny notification handling by allowing payment retries
* Add internal order notes on payment status changes from notification
* Add update payment status to on-hold synchronously via Snap onPending
* Add Google Analytics optional config
= 2.6.6 =
* Add payment instruction pdf link on pending order view
* Add Immediate Reduce Stock optional config
= 2.6.5 =
* Add use map finish url config field
= 2.6.4 =
* Add promo code config field
= 2.6.3 =
* Improve API error handling: Display API error messages to checkout page if any
= 2.6.2 =
* API Library enhancement
= 2.6.1 =
* New payment option for faster credit card transaction via browser's Payment Request API
= 2.6.0 =
* Payment page experience enhancement
= 2.4.5 =
* Optional redirection payment flow added
* Minor payment page experience enhancement
= 2.4.4 =
* Minor payment page experience enhancement
= 2.4.3 =
* Add BCA Klikpay finish page
= 2.4.2 =
* Fix Expire notification Handler
* Separate payment page into a file
= 2.4.1 =
* Backward compatibility for both WC v3 & v2
= 2.4.0 =
* Two-click & One-click feature added
= 2.3.0 =
* Custom fields feature added
= 2.2.0 =
* Clientkey to snap payment page added
* Payment method for promo config added
= 2.1.0 =
* Custom Expiry feature added
= 2.0.0 =
* Bump version to match Woocommerce official plugin repo version
= 1.0 =
* First release!
* Fullpayment feature
== Upgrade Notice ==
= 2.32.3 - 2024-08-15 =
* add identifier to handle webhook, get transaction status, and refund using Dana
* bump tested compatibility with current latest version of WordPress & WooCommerce (php 8.2, WP version 6.6, WooCommerce 9.1.2)
= 2.32.2 - 2023-01-02 =
* prevent issue of Midtrans payment webhook notification of refund status causing unexpected error on WooCommerce
* bump tested compatibility with current latest version of WordPress & WooCommerce
= 2.32.1 - 2021-02-08 =
* minor plugin size reduction by removing unused assets
* update payment icon logo for brimo & dandan with current version
= 2.32.0 - 2021-09-22 =
* improve payment icon visual: add semi transparet background & border for better compatibility with dark color theme, prevent image stretched on some themes, add spacing
* improve notif handler to allow retry of 'expire' card payment (abandoned on 3DS step)
* add WP filter hook 'midtrans_gateway_icon_before_render' modify payment icons HTML image tag
= 2.31.1 - 2021-09-01 =
* improve compatibility with external optimizer plugins on payment page JS (remove jQuery dependency)
= 2.31.0 - 2021-08-26 =
* handle duplicated Snap order_id (incase WP is reinstalled, or DB restored) by auto-adding suffix
* improvement on finish url redirect flow, to prevent issue
* handle uncaught error on finish url
* immediate-reduce-stock disabled by default
* emmit custom headers & metadata on http request
= 2.30.1 - 2021-08-09 =
* prevent issue "cannot inherit abstract function" on outdated PHP v5.0.0 - v5.3.8 & v7.0.0 - v7.1.x
* minor description improvement
* add config to allow [Customize WooCommerce Order Status upon Payment Paid ](https://docs.midtrans.com/en/snap/with-plugins?id=advanced-customize-woocommerce-order-status-upon-payment-paid)
= 2.30.0 - 2021-08-06 =
* major feature: sub [specific gateway buttons for each](https://docs.midtrans.com/en/snap/with-plugins?id=advanced-specific-payment-buttons) supported payment methods
* improve config page UI section separation
* add notif url config value recommendation on config page UI
* immediate-reduce-stock enabled by default
* improve gateway payment button naming
* add config field to allow customize payment button icons
* add built in payment icon assets
* improve UI, messaging clarity, and order of advanced config
* added some custom [wp hooks](https://github.com/veritrans/SNAP-Woocommerce/#available-custom-hooks)
= 2.22.0 - 2021-04-27 =
* prevent issue of 3rd party Cloudflare plugin breaking payment page (reload repetitively)
* improve configuration page structure and description
* enhance "ignore pending status" config
= 2.21.0 - 2021-03-08 =
* improve compatibility: prepare future WP >5.7 CSP on js script tag
* minor payment page js enhancement
= 2.20.0 - 2021-03-03 =
* ensure compatibility with WP 5.7
* better compatibility: prevent conflict with other plugins with Midtrans library
* remove jquery dependency
* minor formatting and description improvement on payment page
= 2.19.0 - 2020-08-19 =
* fix library incomplete update
* bugfix save card feature
* bugfix promo feature
* better compatibility: prevent conflict of function & vars with other plugins
* updated plugin descriptions
* performance improvement on handling debit finish page
= 2.18.4 - 2020-06-25 =
* add acquring_bank field on credit card full payment (main payment)
* fix logic code on midtrans logger
= 2.18.3 - 2020-05-13 =
* hide 3ds and save card configuration field on midtrans subscription admin and make it active
* add plugin action links
* fix typo on description plugin detail
* improve get_environment method
* add wiki link on subscription method description
* update handling notif when order id not exist on WC dashboard
* change payment option name `Midtrans Credit Card Direct`
= 2.18.2 – 2020-04-30 =
* hot fix remove deprecated method
= 2.18.1 – 2020-04-27 =
* fix handling notif if wc_subscription not installed skip the validateSubscriptionTransaction()
= 2.18.0 – 2020-04-23 =
* add midtrans subscription method for Woocommerce Subscriptions
= 2.17.2 – 2020-04-08 =
* clean up code
* add more descriptive wording on description default value
* fix code to prevent the notif_handler class being called multiple times
* improve method setLogRequest
* add cancel transaction method
= 2.17.1 – 2020-04-06 =
* Fix code for backward compatibility php 5.6
= 2.17.0 – 2020-03-26 =
* Add Logging option on admin settings
* Refactoring code
* Tweak fullpayment payment method enabled by default
* Replace deprecated methods
= 2.16.0 =
* Replace veritrans with midtrans php lib
* Add refund method
= 2.14.0 =
* Enhance finish page for BCA Klikpay
= 2.13.0 =
* Output optimization
* Add config to prevent redirect & ignore on `pending` status
= 2.12.0 =
* Updated API library to ensure smooth API connection
= 2.11.0 =
* UX improvement for pending payment
= 2.10.0 =
* Code cleanup
= 2.9.0 =
* Replace order notes to order metadata
= 2.8.0 =
* Removed separate MIGS button for installment & fullpayment
* Installment terms for online installment now configurable
* Installment banks for online installment now configurable
* Installment terms for offline installment now configurable
* Installment bank for online installment now configurable
= 2.7.0 =
* Add payment url link on order view
* Improve deny notification handling by allowing payment retries
* Add internal order notes on payment status changes from notification
* Add update payment status to on-hold synchronously via Snap onPending
* Add Google Analytics optional config
* Add Immediate Reduce Stock optional config
= 2.6.6 =
* Add payment instruction pdf link on pending order view
= 2.6.5 =
Add use map finish url config field
= 2.6.4 =
Add promo code config field
= 2.6.3 =
Improve API error handling: Display API error messages to checkout page if any
= 2.6.2 =
API Library enhancement
= 2.6.1 =
New payment option for faster credit card transaction via browser's Payment Request API
= 2.6.0 =
Payment page experience enhancement
= 2.4.5 =
Optional redirection payment flow added
= 2.4.4 =
Minor payment page experience enhancement
= 2.4.1 =
Support for WooCommerce v3 and also backward compatible with WooCommerce v2. Also some additional nice feature like 2 clicks for CC.
= 2.1.0 =
Update for better experince with BCA KlikPay payment methods
= 1.0 =
Support additional feature like installment, MIGS acq, and bin promo.
== Get Help ==
* [Midtrans WooCommerce Configuration Guide](https://docs.midtrans.com/en/snap/with-plugins?id=wordpress-woocommerce)
* [Midtrans registration](https://account.midtrans.com/register)
* [Midtrans Support Contact](https://midtrans.com/id/contact-us)
* [Midtrans Documentation](https://docs.midtrans.com)
* [Midtrans-WooCommerce Wiki](https://github.com/veritrans/SNAP-Woocommerce/wiki)