=== CatCode TapPay Payments for WooCommerce ===
Contributors: catcode
Tags: tappay, payment gateway, taiwan, credit card, woocommerce
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Accept credit and debit cards in WooCommerce through TapPay (Cherri Tech, Taiwan): secure card fields, 3D Secure, payment confirmed by the Record API.

== Description ==

For WooCommerce shops in Taiwan that use TapPay as their payment service. You need your own TapPay account (Portal) with an App ID, App Key, Partner Key and Merchant ID.

* Card fields on your checkout, served by TapPay (TPDirect). The card number never reaches your server.
* Works with the classic checkout and the block checkout.
* 3D Secure: the customer is sent to the TapPay payment page and comes back to the order.
* Safe confirmation: the order is marked paid only after the plugin has asked the TapPay Record API for the transaction and checked the order number and the amount. A forged return address or notification cannot pay an order.
* A declined card keeps the cart and shows a clear message; the customer can try again.
* Sandbox and production keys side by side, one switch. The Partner Key is stored encrypted.
* Prices in New Taiwan dollars (TWD). The method is hidden for other currencies.
* Traditional Chinese (zh_TW) and English.
* Compatible with HPOS.

= Pro =

* Full and partial refunds from the WooCommerce order, sent to TapPay.
* Order action "Check the payment at TapPay": asks TapPay again and fixes the order status.
* Updates of the plugin from catcode.com.ua.

= External service =

The plugin sends data to TapPay (Cherri Tech Co., Ltd.). The checkout page loads the TPDirect script from js.tappaysdk.com. The server sends the payment (one-time card token, amount, order number, name, e-mail and phone of the cardholder) to prod.tappaysdk.com, or to sandbox.tappaysdk.com in test mode, and asks the same service for the status of a transaction. API documentation: https://docs.tappaysdk.com/tutorial/en/back.html TapPay site: https://www.tappay.tw/

The Pro licence is checked at catcode.com.ua: the key and the address of the site are sent. Terms: https://catcode.com.ua/terms/

== Installation ==

1. Install and activate the plugin. WooCommerce must be active and the store currency must be TWD.
2. Go to WooCommerce, Settings, Payments, TapPay.
3. Enter the sandbox keys from the TapPay Portal and test a payment. Switch test mode off after TapPay has approved your site and you have the production keys.
4. The site must use HTTPS: TapPay notifies only https addresses on port 443.

== Frequently Asked Questions ==

= Which currencies work? =

New Taiwan dollar (TWD) only in this version.

= Is the card number stored? =

No. The card is typed into TapPay fields; the plugin only receives a one-time token.

= The order stays on hold after 3D Secure. =

The order is confirmed when TapPay notifies your site or the customer returns. Make sure the site is reachable over HTTPS from the internet.

== Changelog ==

= 1.0.0 =
* First release.
