PayNKolay for WooCommerce
Paynkolay WooCommerce plugin
by PayNKolay · github.com/paynkolay/paynkolay-woocommerce · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/paynkolay/paynkolay-woocommerce/archive/refs/heads/main.zipWooCommerce payment gateway plugin for PayNKolay virtual POS. Accept credit card payments on your WooCommerce store with 3D Secure support.
PayNKolay sanal POS ile WooCommerce mağazanızda kredi kartı ile 3D Secure destekli ödeme alın.
Features
- 3D Secure payment support
- WooCommerce Blocks (new checkout) compatibility
- WooCommerce Subscriptions support
- Test mode for development and testing
- Hash verification for transaction security
- Turkish language support
Requirements
| Requirement | Version |
|---|---|
| WordPress | 5.8+ |
| WooCommerce | 6.0+ |
| PHP | 7.4+ |
Installation
Manual Installation
- Download the latest release
.zipfile - Go to WordPress Admin > Plugins > Add New > Upload Plugin
- Upload the
.zipfile and click Install Now - Activate the plugin
From Source
git clone https://github.com/paynkolay/paynkolay-woocommerce.git
cd paynkolay-woocommerce
npm install # optional, only needed for JS development
Copy or symlink the plugin directory into wp-content/plugins/.
Configuration
- Go to WooCommerce > Settings > Payments
- Enable Pay N Kolay
- Click Manage and fill in the settings:
| Setting | Description |
|---|---|
| Token (SX) | Your merchant token from the PayNKolay dashboard |
| Merchant Secret Key | Your secret key from the PayNKolay dashboard |
| Test Mode | Enable to use the test environment for development |
Test Mode
When test mode is enabled, transactions are processed through the PayNKolay test environment (paynkolaytest.nkolayislem.com.tr). No real charges are made.
You can obtain test credentials from your PayNKolay merchant dashboard.
Development
Prerequisites
Local Development Environment
# Start a local WordPress environment with WooCommerce
npx wp-env start
# Watch for JS changes and rebuild
npm run start
# Build for production
npm run build
# Create a distributable zip
npm run plugin-zip
Project Structure
paynkolay-woocommerce/
├── assets/js/frontend/ # Built JS (checked in for distribution)
├── includes/ # PHP classes
│ ├── blocks/ # WooCommerce Blocks integration
│ └── class-wc-gateway-paynkolay.php
├── languages/ # Translation files
├── src/js/frontend/ # JS source files
├── views/ # Payment form templates
├── tests/ # PHPUnit tests
└── woocommerce-gateway-paynkolay.php # Main plugin file
Contributing
Contributions are welcome! Please open an issue or submit a pull request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/my-feature) - Commit your changes (
git commit -m 'Add my feature') - Push to the branch (
git push origin feature/my-feature) - Open a Pull Request
License
This project is licensed under the MIT License.