{"id":400278,"date":"2026-11-16T13:36:51","date_gmt":"2026-11-16T13:36:51","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/y2kwebs-gateway-for-bac\/"},"modified":"2026-11-16T13:51:25","modified_gmt":"2026-11-16T13:51:25","slug":"y2kwebs-bac","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/y2kwebs-bac\/","author":14923355,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.2","stable_tag":"1.0.2","tested":"7.1.4","requires":"6.9","requires_php":"7.4","requires_plugins":null,"header_name":"Y2KWebs Gateway for BAC","header_author":"Y2KWebs","header_description":"Pagos de contado mediante PowerTranz SPI 3DS para cuentas CRC y USD.","last_updated":"2026-11-16 13:51:25","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/Y2KWebs\/y2kwebs-bac","header_author_uri":"https:\/\/y2kwebs.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":57,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.1":{"tag":"1.0.1","author":"y2kwebs","date":"2026-11-16 13:36:18","revision":3805265},"1.0.2":{"tag":"1.0.2","author":"y2kwebs","date":"2026-11-16 13:51:25","revision":3805290}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3805265,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3805265,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3805265,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3805265,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.1","1.0.2"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3805265,"resolution":"1","location":"assets","locale":"","width":1071,"height":1489},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3805265,"resolution":"2","location":"assets","locale":"","width":908,"height":2071}},"screenshots":{"1":"Gateway settings in Spanish with fictitious merchant accounts and write-only password fields.","2":"Checkout Blocks with fictitious demo data."}},"plugin_section":[],"plugin_tags":[293165,132031,1887,271327,286],"plugin_category":[45],"plugin_contributors":[290356],"plugin_business_model":[],"class_list":["post-400278","plugin","type-plugin","status-publish","hentry","plugin_tags-bac","plugin_tags-costa-rica","plugin_tags-payments","plugin_tags-powertranz","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-y2kwebs","plugin_committers-y2kwebs"],"banners":{"banner":"https:\/\/ps.w.org\/y2kwebs-bac\/assets\/banner-772x250.png?rev=3805265","banner_2x":"https:\/\/ps.w.org\/y2kwebs-bac\/assets\/banner-1544x500.png?rev=3805265","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/y2kwebs-bac\/assets\/icon-128x128.png?rev=3805265","icon_2x":"https:\/\/ps.w.org\/y2kwebs-bac\/assets\/icon-256x256.png?rev=3805265","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/y2kwebs-bac\/assets\/screenshot-1.jpg?rev=3805265","caption":"Gateway settings in Spanish with fictitious merchant accounts and write-only password fields."},{"src":"https:\/\/ps.w.org\/y2kwebs-bac\/assets\/screenshot-2.jpg?rev=3805265","caption":"Checkout Blocks with fictitious demo data."}],"raw_content":"<!--section=description-->\n<p>Y2KWebs Gateway for BAC connects WooCommerce to the PowerTranz\/FAC SPI payment service used by compatible BAC Costa Rica merchant accounts.<\/p>\n\n<p>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 <a href=\"https:\/\/y2kwebs.com\/\">Y2KWebs<\/a>.<\/p>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>Features:<\/p>\n\n<ul>\n<li>Separate CRC and USD merchant accounts, selected using the order currency.<\/li>\n<li>Classic checkout and Checkout Blocks.<\/li>\n<li>HPOS-compatible order access.<\/li>\n<li>3DS authentication and financial-response checks before confirming an order.<\/li>\n<li>Protection against concurrent or repeated payment requests.<\/li>\n<li>Uncertain financial results held for manual bank reconciliation.<\/li>\n<li>Optional diagnostics with sensitive fields excluded.<\/li>\n<li>Credentials entered in WooCommerce with encrypted, write-only password storage. Editing wp-config.php is optional.<\/li>\n<\/ul>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<h4>External service and privacy<\/h4>\n\n<p>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.<\/p>\n\n<p>Staging endpoint: https:\/\/staging.ptranz.com\/api\/spi\nProduction endpoint: https:\/\/gateway.ptranz.com\/api\/spi\nProvider documentation: https:\/\/developer.powertranz.com\/ (access may require provider credentials).\nProvider website terms: https:\/\/powertranz.com\/terms-of-use\nProvider privacy policy: https:\/\/powertranz.com\/privacy-policy\nBAC merchant information: https:\/\/ayuda.baccredomatic.com\/para_empresas_o_negocios\/comercios_afiliados\/e-commerce\nBAC Costa Rica e-commerce terms: https:\/\/www.baccredomatic.com\/sites\/default\/files\/2024-07\/cr_carga_de_terminos_condiciones_e-commerce.PDF<\/p>\n\n<p>Website terms do not replace the merchant's payment-service agreement. Confirm applicable conditions and card-data compliance obligations with BAC\/PowerTranz.<\/p>\n\n<p>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.<\/p>\n\n<h3>Credits<\/h3>\n\n<p>Developed and maintained by Y2KWebs. Credit to JARS Costa Rica for the historical reference integration; this maintained implementation uses an independent architecture and identity.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate WooCommerce. Use HTTPS.<\/li>\n<li>Upload the plugin ZIP through Plugins &gt; Add Plugin &gt; Upload Plugin and activate it.<\/li>\n<li>Open WooCommerce &gt; Settings &gt; Payments &gt; BAC \u2014 Y2KWebs.<\/li>\n<li>Leave the gateway in staging with administrator-only visibility while testing.<\/li>\n<li>Enter compatible CRC\/USD staging credentials, or configure the documented server constants\/environment variables.<\/li>\n<li>Enable the gateway and test the currencies enabled by your bank.<\/li>\n<li>Configure your own production credentials and open customer visibility only when ready.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"what%20language%20does%20the%20plugin%20use%3F\"><h3>What language does the plugin use?<\/h3><\/dt>\n<dd><p>Settings follow the administrator\u2019s 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.<\/p><\/dd>\n<dt id=\"does%20this%20work%20with%20any%20bac%20merchant%20account%3F\"><h3>Does this work with any BAC merchant account?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"do%20i%20have%20to%20edit%20wp-config.php%3F\"><h3>Do I have to edit wp-config.php?<\/h3><\/dt>\n<dd><p>No. Enter the CRC\/USD merchant identifiers and passwords in WooCommerce &gt; Settings &gt; Payments &gt; BAC \u2014 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.<\/p><\/dd>\n<dt id=\"which%20authentication%20results%20are%20allowed%3F\"><h3>Which authentication results are allowed?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"what%20happens%20after%20a%20timeout%3F\"><h3>What happens after a timeout?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"can%20i%20refund%20a%20payment%20from%20woocommerce%3F\"><h3>Can I refund a payment from WooCommerce?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"where%20are%20logs%3F\"><h3>Where are logs?<\/h3><\/dt>\n<dd><p>Enable diagnostic logging, then open WooCommerce &gt; Status &gt; 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.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20the%20plugin%20is%20removed%3F\"><h3>What happens when the plugin is removed?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>English source strings and a complete bundled Spanish translation for all Spanish locales.<\/li>\n<li>Prefer official regional language packs and preserve merchant-defined payment titles and descriptions.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Load the 3DS listener and bank-return script through the WordPress script API.<\/li>\n<li>Validate payment-result messages by source window, origin, order and local destination.<\/li>\n<li>Use an external callback script with a same-origin Content Security Policy.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First public edition for BAC Costa Rica using PowerTranz\/FAC SPI 3DS.<\/li>\n<li>CRC\/USD accounts, classic checkout, Checkout Blocks and HPOS.<\/li>\n<li>Serialized payment attempts and manual reconciliation for uncertain financial results.<\/li>\n<\/ul>","raw_excerpt":"Accept card payments with BAC Costa Rica through PowerTranz SPI 3DS. Supports CRC, USD, classic checkout, Blocks and HPOS.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/400278","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=400278"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/y2kwebs"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=400278"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=400278"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=400278"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=400278"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=400278"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=400278"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}