paytic / omnipay-btipay
omnipay driver for BT IPay from Banca Transilvania
dev-main
2026-11-17 08:55 UTC
Requires
- php: ^7.4|^8.0
- ext-dom: *
- http-interop/http-factory-guzzle: ^1.2
- lcobucci/jwt: ^4.1|^5.0
- paytic/omnipay-common: ^3.0
- stev/btipay: ^0.1|^1.0
Requires (Dev)
- bytic/phpqatools: ^1.0
- omnipay/tests: ^3|^4
- symfony/http-client: ^5.0|^6.0
- vlucas/phpdotenv: ^2.3
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-17 09:02:17 UTC
README
omnipay driver for BT IPay from Banca Transilvania
Card-on-file (COF)
The gateway supports BT iPay's COF operations using the authenticated REST API. COF API calls use the recommended HTTP Basic authorization header; the existing checkout flow continues to use the original BT iPay client.
createCard()registers a zero-value card verification order. SupplyclientId,orderId,returnUrl, and the customer'scard; redirect the customer to the response URL to complete card verification. To save a card during a payment, passclientIdtopurchase(); the usual checkout flow is preserved otherwise.purchaseWithSavedCard()starts a customer-initiated payment withclientIdandbindingId. OptionalscaExemptionvalues areTRA,LVP, orSCP.merchantInitiatedPurchase()registers a payment with theMITexemption and submits it throughpaymentOrderBinding.do. SupplyclientIdandbindingId.getBindings()lists saved cards and supportsshowExpiredandincludeCardArt; the response exposes the returnedbindingsarray.bindCard()/unbindCard()reactivate or deactivate a saved card bybindingId.getOrderStatusExtended()retrieves transaction details, includingbindingInfowhen available.paymentOrderBinding()exposes the binding payment endpoint for an order that has already been registered.
Use the gateway's testMode setting to select the BT iPay sandbox or production
endpoint. COF must be enabled for the merchant by Banca Transilvania. Obtain and
record the customer's consent before sending a clientId to save a card, and only
use SCA exemptions agreed with the bank.