Kal-í CR
Repositories
2
 Projects Packages
21

kalicr/bacfac (1.0.20)

Published 2026-08-10 22:00:16 +00:00 by kalicr-packages

Installation

{
	"repositories": [{
			"type": "composer",
			"url": ""
		}
	]
}
composer require kalicr/bacfac:1.0.20

About this package

Magento 2 payment method integrating BAC Credomatic via First Atlantic Commerce (FAC)/PowerTranz — authorizes card payments through a 3-phase hosted flow (init, 3DS challenge, completion) with optional installment plans.

KaliCR Logo

Module Kalicr_BACFAC

Magento 2 payment method integrating BAC Credomatic via First Atlantic Commerce (FAC)/PowerTranz. Authorizes card payments through a 3-phase gateway flow (initialize → 3D Secure challenge → completion), as an alternative to the direct/embedded CardinalCommerce integration provided by Kalicr_Bac.

This module is developed by Kal-i CR Development Team.

Features

  • Payment method kalicr_bacfac: gateway-style method (KalicrBACFACPaymentFacade, a virtual type of Magento\Payment\Model\Method\Adapter) supporting authorize/capture through PowerTranz's SPI API.
  • 3-phase transaction flow:
    1. Gateway\Command\Initialize (Phase 1) — opens the transaction and submits order/billing/shipping data (Gateway\Request\Builder\Phase1\*).
    2. Gateway\Command\Validate3DS (Phase 2) — validates the 3D Secure challenge result.
    3. Gateway\Command\CompletePayment (Phase 3) — completes the transaction with the SPI token (Gateway\Request\Builder\Phase3\SPIToken) and sends the confirmation email (Gateway\Response\Phase3\SendEmail).
  • 3D Secure: toggled from admin (three_d_secure), with configurable accepted status codes (three_d_statuses).
  • Phase-specific exceptions: Gateway\Exceptions\Phase2Exception, Phase3Exception, NonValidException, NonSuchOrder map gateway failures to specific handling per phase.
  • Public API: Api\InitiateOperationInterface and Api\CreditCardDetailsInterface expose the phase-1 initiation and the card-details data object for consumers outside the module (e.g. the Controller\BACFAC\PayWithFac post-back endpoint).
  • Payment info labels plugin (Plugin\Block\Info): overrides how additional payment information is labeled on the admin/frontend order view.
  • Debug logging: dedicated logger (Model\Logger) for gateway request/response tracing.
  • Installments ("Tasa 0"): admin-configurable list of quota plans (quotas grid, Block\Adminhtml\Form\Field\Cuotas) and customer-facing copy (texto_opcion_pago_cuotas, etiqueta_combo_cuotas). The selection UI and its Observer\DataAssignObserver wiring currently live only in the one-step checkout renderer (bacfac-onestep.js/cc-fields-onestep.html), which is not wired into either site's active checkout layout today (checkout_index_index.xml only registers the standard kalicr_bacfac renderer) and depends on a Kalicr_Checkout module that doesn't exist in this codebase yet — see CHANGELOG.md 1.0.19. Treat this feature as dormant/prepared, not active, until that dependency is resolved.

Admin Configuration

Stores → Configuration → Payment Methods → Kalicr BACFAC

Field Description
Activo (active) Enables/disables the payment method
Título (title) Title shown to the customer at checkout
Tipos de Tarjeta (cctypes) Allowed card types (VI, MC, AE by default)
Modo Sandbox (sandbox_mode) Toggles sandbox vs. production endpoint
Endpoint URL / Endpoint URL Sandbox PowerTranz SPI API base URLs (production/sandbox)
Acción de Pago (payment_action) Payment action: Authorize, or Authorize & Capture
3D Secure (three_d_secure) Enables the 3DS challenge in Phase 2
Estados 3DS Aceptados (three_d_statuses) Accepted 3DS status codes (e.g. Y)
Validar Dirección (address_match) Enables AVS address matching
Usuario/Contraseña Pago de Contado Credentials used for the non-installment (contado) flow
Texto Opción Cuotas / Etiqueta Combo Cuotas Customer-facing copy for the installments prompt
Cuotas (quotas) Grid of installment plans offered to the customer
Logo BACFAC (bacfaclogo) Image shown next to the payment method
Instrucciones (instructions) Instructions shown to the customer (HTML allowed)
Timeout (timeout) Gateway request timeout

Installation

Via Composer

composer require kalicr/bacfac
bin/magento module:enable Kalicr_BACFAC
bin/magento setup:upgrade
bin/magento cache:clean

Manual installation

  1. Copy the module into app/code/Kalicr/BACFAC.
  2. Run:
bin/magento module:enable Kalicr_BACFAC
bin/magento setup:upgrade
bin/magento cache:clean

Dependencies

  • PHP: ^8.1 || ^8.2 || ^8.3
  • Composer packages:
    • magento/framework
    • magento/module-backend
    • magento/module-checkout
    • magento/module-cms
    • magento/module-config
    • magento/module-directory
    • magento/module-payment
    • magento/module-quote
    • magento/module-sales

Compatibility

  • Adobe Commerce / Magento Open Source: 2.4.6, 2.4.7, 2.4.8
  • PHP: ^8.1 || ^8.2 || ^8.3

Technical notes

  • Payment method virtual type: KalicrBACFACPaymentFacade (Magento\Payment\Model\Method\Adapter), configured under payment/kalicr_bacfac/*
  • Method code constant: Kalicr\BACFAC\Model\Ui\ConfigProvider::METHOD_CODE
  • Command pool (KalicrBACFACCommandPool): initialize → Gateway\Command\Initialize, process_3ds → Gateway\Command\Validate3DS, completepayment → Gateway\Command\CompletePayment (as KalicrBACFACPlaceAction)
  • Gateway HTTP clients: Gateway\Http\Phase1\Client, Gateway\Http\Phase3\Client against PowerTranz's /api/spi endpoint
  • Gateway response handlers: Gateway\Response\Phase1\PaymentData, Phase2\PaymentData, Phase3\PaymentData, Phase3\SendEmail
  • Gateway validators: Gateway\Validator\Phase1\ResponseValidator, Phase2\ResponseValidator, Phase3\ResponseValidator
  • Controller endpoints: Controller\BACFAC\PayWithFac (initiates the transaction), ProcessResponse (handles the gateway callback), CancelOrder
  • Debug logger: Model\Logger, wired as a virtual type in etc/di.xml
  • Config paths are rooted at payment/kalicr_bacfac/*

Changelog

Release notes are maintained in CHANGELOG.md.

Support

If you need help with this module, contact Kal-i CR Development Team:

  • Email: contacto@kalicr.com

License

This package is distributed under the proprietary KaliCR commercial license. See LICENSE.md.

Release workflow

This repository publishes the package through Forgejo Composer Registry.

Dependencies

Dependencies

ID Version
magento/framework >=103.0
magento/module-backend >=102.0
magento/module-checkout >=100.4
magento/module-cms >=104.0
magento/module-config >=101.2
magento/module-directory >=100.4
magento/module-payment >=100.4
magento/module-quote >=101.2
magento/module-sales >=103.0
php ^8.1 || ^8.2 || ^8.3
Details
Composer
2026-08-10 22:00:16 +00:00
2
Kal-i CR Development Team
proprietary
135 KiB
Assets (1)
kalicr-bacfac.1.0.20.zip 135 KiB
Versions (1) View all
1.0.20 2026-08-10