Title: Y2KWebs Gateway for BAC
Author: Y2K Webs
Published: <strong>November 16, 2026</strong>
Last modified: November 16, 2026

---

Search plugins

![](https://ps.w.org/y2kwebs-bac/assets/banner-772x250.png?rev=3805265)

![](https://ps.w.org/y2kwebs-bac/assets/icon-256x256.png?rev=3805265)

# Y2KWebs Gateway for BAC

 By [Y2K Webs](https://profiles.wordpress.org/y2kwebs/)

[Download](https://downloads.wordpress.org/plugin/y2kwebs-bac.1.0.2.zip)

 * [Details](https://wordpress.org/plugins/y2kwebs-bac/#description)
 * [Reviews](https://wordpress.org/plugins/y2kwebs-bac/#reviews)
 *  [Installation](https://wordpress.org/plugins/y2kwebs-bac/#installation)
 * [Development](https://wordpress.org/plugins/y2kwebs-bac/#developers)

 [Support](https://wordpress.org/support/plugin/y2kwebs-bac/)

## Description

Y2KWebs Gateway for BAC connects WooCommerce to the PowerTranz/FAC SPI payment service
used by compatible BAC Costa Rica merchant accounts.

The plugin is free and open source. You need your own merchant agreement and compatible
PowerTranz SPI credentials. Bank fees and payment-service conditions are separate.
No Y2KWebs account, subscription or paid support is required. Optional installation
and professional support are available from [Y2KWebs](https://y2kwebs.com/).

The gateway uses English source strings and includes a complete Spanish translation
for every Spanish WordPress locale. Official regional language packs take precedence
when available. User documentation remains in Spanish.

This is an independent integration. It is not an official plugin from BAC, PowerTranz
or WooCommerce and does not imply their endorsement. All trademarks belong to their
respective owners.

Features:

 * Separate CRC and USD merchant accounts, selected using the order currency.
 * Classic checkout and Checkout Blocks.
 * HPOS-compatible order access.
 * 3DS authentication and financial-response checks before confirming an order.
 * Protection against concurrent or repeated payment requests.
 * Uncertain financial results held for manual bank reconciliation.
 * Optional diagnostics with sensitive fields excluded.
 * Credentials entered in WooCommerce with encrypted, write-only password storage.
   Editing wp-config.php is optional.

Only one-time sales are supported. Automatic refunds, recurring payments, stored
cards, installments and currency conversion are not included. Compatibility with
other countries or every BAC payment product is not claimed.

Requirements: WooCommerce 9.0 or later, HTTPS, PHP OpenSSL with AES-256-GCM and 
MySQL/MariaDB with GET_LOCK support, in addition to the WordPress/PHP versions listed
above. Live Visa and Mastercard approvals have been verified in both CRC and USD.
Automated tests use a simulated bank; provider staging validation remains pending.
This does not establish support for every card brand or merchant account.

#### External service and privacy

PowerTranz/FAC is required to authenticate and process payments. When a customer
submits card details, the plugin transmits the cardholder name, card number, expiry
and CVV, billing name and address, country, email, phone, order reference, transaction
identifier, amount, currency and merchant callback URL to the configured PowerTranz
endpoint. The initial request also includes merchant credentials. The bank/issuer
may load its own 3DS challenge in an iframe and collect device or authentication
information.

Staging endpoint: https://staging.ptranz.com/api/spi
 Production endpoint: https://
gateway.ptranz.com/api/spi Provider documentation: https://developer.powertranz.
com/ (access may require provider credentials). Provider website terms: https://
powertranz.com/terms-of-use Provider privacy policy: https://powertranz.com/privacy-
policy BAC merchant information: https://ayuda.baccredomatic.com/para_empresas_o_negocios/
comercios_afiliados/e-commerce BAC Costa Rica e-commerce terms: https://www.baccredomatic.
com/sites/default/files/2024-07/cr_carga_de_terminos_condiciones_e-commerce.PDF

Website terms do not replace the merchant’s payment-service agreement. Confirm applicable
conditions and card-data compliance obligations with BAC/PowerTranz.

PAN, CVV and SPI tokens are not persisted by this plugin. SPI direct transmits card
data through the merchant server in memory; this is not hosted tokenization. WooCommerce
retains its normal order and billing records. The plugin retains non-sensitive transaction
references, status and redacted diagnostics; temporary 3DS redirect HTML and a hashed
callback state are used during authentication. Merchant credentials saved in WooCommerce
remain in its database; server constants or environment variables are recommended.
There is no analytics or telemetry sent to Y2KWebs.

### Credits

Developed and maintained by Y2KWebs. Credit to JARS Costa Rica for the historical
reference integration; this maintained implementation uses an independent architecture
and identity.

## Screenshots

[⌊Gateway settings in Spanish with fictitious merchant accounts and write-only password
fields.⌉⌊Gateway settings in Spanish with fictitious merchant accounts and write-
only password fields.⌉[

Gateway settings in Spanish with fictitious merchant accounts and write-only password
fields.

[⌊Checkout Blocks with fictitious demo data.⌉⌊Checkout Blocks with fictitious demo
data.⌉[

Checkout Blocks with fictitious demo data.

## Installation

 1. Install and activate WooCommerce. Use HTTPS.
 2. Upload the plugin ZIP through Plugins > Add Plugin > Upload Plugin and activate
    it.
 3. Open WooCommerce > Settings > Payments > BAC — Y2KWebs.
 4. Leave the gateway in staging with administrator-only visibility while testing.
 5. Enter compatible CRC/USD staging credentials, or configure the documented server
    constants/environment variables.
 6. Enable the gateway and test the currencies enabled by your bank.
 7. Configure your own production credentials and open customer visibility only when
    ready.

## FAQ

### What language does the plugin use?

Settings follow the administrator’s language; checkout fields and payment messages
follow the store language. English and bundled Spanish are available immediately.
All Spanish locales use the bundled translation when an official regional translation
is missing. Saved payment titles and descriptions are preserved. User guides remain
in Spanish. Directory translations are reviewed separately by the WordPress community.

### Does this work with any BAC merchant account?

No. It requires a BAC Costa Rica account provisioned for the compatible PowerTranz/
FAC SPI service. Ask the bank which integration and currencies your account supports.

### Do I have to edit wp-config.php?

No. Enter the CRC/USD merchant identifiers and passwords in WooCommerce > Settings
> Payments > BAC — Y2KWebs. Passwords are encrypted using AES-256-GCM in a separate
non-autoloaded option. Forms and WooCommerce API responses never return them. Blank
password fields keep saved values; explicit deletion removes both passwords and 
disables the gateway. Changing WordPress authentication salts requires entering 
the passwords again. Constants and environment variables remain optional alternatives
for managed installations.

### Which authentication results are allowed?

Y and A. U is disabled by default and requires an explicit setting. N, R and unknown
results cannot proceed to financial completion. A valid authentication result alone
does not complete the WooCommerce order: the final bank approval must also match
the order.

### What happens after a timeout?

If financial completion was sent but its outcome cannot be established, the order
is placed on hold and further financial requests for that attempt are blocked. Reconcile
it with the bank before accepting another payment. There is no automatic financial
retry or bank-status query in this version.

### Can I refund a payment from WooCommerce?

Automatic bank refunds are not implemented. Refund through the bank and record the
refund manually in WooCommerce. Changing an order status does not send money.

### Where are logs?

Enable diagnostic logging, then open WooCommerce > Status > Logs and select y2kwebs-
bac. Never publish real order exports or raw bank responses. Diagnostic fields exclude
card data, passwords, SPI tokens, challenge HTML and cryptographic authentication
values.

### What happens when the plugin is removed?

Deactivation leaves order records and settings available. Uninstall deletes this
gateway’s settings, including database-stored credentials, and preserves order transaction
history for reconciliation. No other gateway’s settings are migrated or deleted.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Y2KWebs Gateway for BAC” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Y2K Webs ](https://profiles.wordpress.org/y2kwebs/)

[Translate “Y2KWebs Gateway for BAC” into your language.](https://translate.wordpress.org/projects/wp-plugins/y2kwebs-bac)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/y2kwebs-bac/), check
out the [SVN repository](https://plugins.svn.wordpress.org/y2kwebs-bac/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/y2kwebs-bac/) by
[RSS](https://plugins.trac.wordpress.org/log/y2kwebs-bac/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.2

 * English source strings and a complete bundled Spanish translation for all Spanish
   locales.
 * Prefer official regional language packs and preserve merchant-defined payment
   titles and descriptions.

#### 1.0.1

 * Load the 3DS listener and bank-return script through the WordPress script API.
 * Validate payment-result messages by source window, origin, order and local destination.
 * Use an external callback script with a same-origin Content Security Policy.

#### 1.0.0

 * First public edition for BAC Costa Rica using PowerTranz/FAC SPI 3DS.
 * CRC/USD accounts, classic checkout, Checkout Blocks and HPOS.
 * Serialized payment attempts and manual reconciliation for uncertain financial
   results.

## Meta

 *  Version **1.0.2**
 *  Last updated **19 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.9 or higher **
 *  Tested up to **7.1.4**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [costa rica](https://wordpress.org/plugins/tags/costa-rica/)[payments](https://wordpress.org/plugins/tags/payments/)
   [powertranz](https://wordpress.org/plugins/tags/powertranz/)[woocommerce](https://wordpress.org/plugins/tags/woocommerce/)
 *  [Advanced View](https://wordpress.org/plugins/y2kwebs-bac/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/y2kwebs-bac/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/y2kwebs-bac/reviews/)

## Contributors

 *   [ Y2K Webs ](https://profiles.wordpress.org/y2kwebs/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/y2kwebs-bac/)