# Koin Official Payments for WooCommerce
Contributors: apiki, aguiart0
Tags: payments, WooCommerce, store, shop, checkout, cart, koin, wirecard, loja, ecommerce
Requires at least: 5.0
Tested up to: 6.8
Stable tag: 1.3.20
Requires PHP: 7.4
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl-3.0.html

## Description
Payment plugin for WooCommerce using Koin payer services.

### Integration with Koin
This plugin uses Koin's API to process payments via boleto, Pix, and credit card. When using the plugin, payment data is transmitted to the following services:
- Production environment: [https://api-payments.koin.com.br](https://api-payments.koin.com.br/)
- Sandbox environment: [https://api-sandbox.koin.com.br](https://api-sandbox.koin.com.br/)
This plugin uses Despegar's device fingerprinting service to enhance transaction security via Koin's API. This process helps ensure transactions are not interrupted by anti-fraud measures. The URL [https://securegtm.despegar.com](https://securegtm.despegar.com/) is used to capture the fingerprint, and while it differs from Koin's main URLs, it belongs to the same corporate group. Therefore, Koin's terms of use and privacy policies also apply to this service.

### Terms of Use and Privacy Policies
Please refer to the following links for more information about Koin's terms of use and privacy policies:
- [Terms of Use](https://termos.koin.com.br/)
- [Privacy Policy](https://www.koin.com.br/politica-de-privacidade/)

### Integration with Ipify
This plugin also uses the Ipify API ([https://api.ipify.org](https://api.ipify.org/)) to obtain the user's IP address, which is used to improve anti-fraud features during credit card transactions.

### Payment Methods:
- Ticket payments by installments (BNPL)
- Credit Card
- PIX

= Requirements: =
- PHP version 7.4 or higher.

== Installation ==
1. Upload this plugin to your WordPress site and activate it.
2. Configure your Koin account in the WooCommerce payment settings.

== Screenshots ==
- Screenshots

== Changelog ==
= 1.3.20 = - 2026-04-02
- Added custom document type support for buyer documents

= 1.3.19 = - 2026-01-19
- Improved buyer document data formatting
- Enhanced document type handling for LATAM countries

= 1.3.18 = - 2026-01-13
- Fixed issue with manual order synchronization
- Adjustments to field validation in installment rules
- Adjustments to WooCommerce email triggers for orders that went through "Under Analysis" status

= 1.3.17 = - 2025-11-27
- Added email template for "Under Analysis" status
- Fixes in cancellation and refund processing
- Fix in logic for restocking rejected orders

= 1.3.16 = - 2025-11-10
- Enables installments up to 72x on credit card.
- Fixes behavior of private order notes added by the plugin.
- Fixes display of checkout credit card fields when payment method description is blank.

= 1.3.15 = - 2025-10-13
- Adds option for debit card payment

= 1.3.14 = - 2025-09-18
- Fixes the behavior of opening the BNPL banner on blocks checkout

= 1.3.13 = - 2025-09-18
- Implements the possibility to associate an installment rule with a specific product, category, or brand

= 1.3.12 = - 2025-09-03
- Refactor document fields on blocks checkout

= 1.3.11 = - 2025-08-21
- Send the state name to the payment API when the city field is missing

= 1.3.10 = - 2025-07-07
- Updated Thank you page layout for pix payment method fo desktop and mobile.

= 1.3.9 = - 2025-06-12
- Tested compatibility with WordPress 6.8.1, WooCommerce 9.9.3, and PHP 8.4. No functional changes.

= 1.3.8 = - 2025-05-06
- Tweaks to input validation rules
- Fixes to translation
- Standardized installment display; custom placeholders no longer supported.


= 1.3.7 = - 2025-04-17
- Added toggle button to enable/disable the address number field
- Adjusted installment rules with custom conditional logic

= 1.3.6 = - 2024-12-10
- Added a refund system to process payments

= 1.3.5 = - 2024-11-01
- Add support to LATAM countries
- Implements the registration of specific installment rules

= 1.3.4 = - 2024-10-30
- Fixed variables sanitization

= 1.3.3 = - 2024-10-08
- Update readme.txt service descriptions

= 1.3.2 = - 2024-10-03
- Only load scripts on checkout page

= 1.3.1 = - 2024-08-20
- Fixed WordPress Review Plugins Issues

= 1.3.0 = - 2024-08-11
- Fixed WordPress Review Plugins Issues

= 1.2.9 = - 2024-08-11
- Handle tokenize error

= 1.2.8 = - 2024-08-04
- Parse tokenize card to back-end
- Refactor block checkout

= 1.2.7 = - 2024-07-35
- Add credit card tax controller

= 1.2.6 = - 2024-07-35
- Add discount by payment methods

= 1.2.5 = - 2024-04-24
- Fix number format bug
- Remove comma in price values
- Add new HTTP Header to inform the plugin version

= 1.2.4 = - 2024-03-04
- Compatibility with WooCommerce version 8.6
- Compatibility with the new block checkout
- Compatibility with WordPress version 6.4

= 1.2.3 = - 2024-01-18
- Add new filter to be used by BC - Add-on for Koin Official Payments

= 1.2.2 = - 2023-12-01
- Add a new error message for invalid card and invalid data on checkout
- Add observers on checkout scripts to improve compatibility with other plugins and themes

= 1.2.1 = - 2023-09-11
- Add a new banner image to the boleto method on checkout
- Fix the redirect looping on thank-you page

= 1.2.0 = - 2023-01-23
- Add credit card payment gateway
- Add Pix payment gateway
- Changes the plugin settings for a new tab on WooCommerce settings

= 1.0.3 = - 2023-01-20
- Fix popup script error

= 1.0.2 = - 2022-10-20
- Fix person type requirement
- Add product item description

= 1.0.1 = - 2022-07-28
- Fix return URL
- Refactor logs
- Create account fields
- Request/Response logs

= 1.0.0 = - 2022-05-12
- Initial Release

## Frequently Asked Questions
### Questions about Koin?
Send your inquiries [here](https://www.koin.com.br/atendimento/).
---

## Available Translations
This plugin is available in the following languages:
- **Portuguese**
- **Spanish**
For users wishing to contribute translations, you can visit our plugin's page in the WordPress repository to submit improvements to the translations.
