Koin Official Payments for WooCommerce

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
– Sandbox environment: 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 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
– Privacy Policy

Integration with Ipify

This plugin also uses the Ipify API (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.

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.

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

1. 

   Screenshots

2. 
3. 

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