Download the PHP package darkghosthunter/transbank without Composer
On this page you can find all versions of the php package darkghosthunter/transbank. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package transbank
Transbank
Easy-to-use Transbank SDK for PHP.
Supports Webpay, Webpay Mall and Webpay Oneclick Mall.
Requisites:
- PHP 8.0 or later.
ext-json
- HTTP Client
- Logger (optional)
- Event dispatcher (optional)
Installation
Require it with Composer:
composer require darkghosthunter/webpay
Usage
This SDK mimics all the Webpay, Webpay Mall and Oneclick Mall methods from the official Transbank SDK for PHP.
You can check the documentation of these services in Transbank Developer's site.
Quickstart
Instance the Transbank
object. You can do it manually, or with make()
which will use Guzzle o Symfony HTTP Clients if any of these is already installed.
If your project doesn't manage single instances, you can use getInstance()
to receive a static Transbank instance.
Environments and credentials
By default, this SDK starts up in integration environment, where all transactions made are fake by using Transbank's own integration server.
To operate in production mode, where all transaction will be real, you will need to use toProduction()
along an array
with the name of the service and their production credentials issued by Transbank to you: webpay
, webpayMall
or oneclickMall
.
For Mall operations, the "child" commerce code is only needed when doing the transactions.
Using a Service
To use a Transbank service, just call the method on the Transbank
instance: webpay
, webpayMall
and oneclickMall
.
HTTP Client
This package is compatible with any PSR-18 compliant HTTP Client. IF you don't have one, you can install Guzzle or Symfony
composer require guzzlehttp/guzzle:>=7.0
or
composer require symfony/http-client:>=5.2
Some PHP platforms already ship with their own HTTP Client, like Amp, ReactPHP, or Swoole.
Logger (optional)
You can use this package with any PSR-3 compliant Log system, allowing to debug transactions. You can use Monolog if you don't have one.
composer require monolog/monolog
All operations are sent to the logger using debug
.
Event dispatcher (optional)
You can use this package with any PSR-14 compliant Event Dispatcher, so you will be able to hear transactions started and completed. You can use Symfony or League if you don't have one.
composer require symfony/event-dispatcher
or
composer require league/event
This package sends the following events:
TransactionCreating
before a transaction is created in Transbank.TransactionCreated
after a transaction is created in Transbank, but pending payment.TransactionCompleted
after a transaction or refund is completed in Transbank, regardless of the success.
Excepciones
All exceptions implement TransbankException
, so you can easily catch and check what happened.
Transactions properly rejected by banks or credit card issuers do not throw exceptions.
There are 4 types of exceptions:
ClientException
: Any error byproduct of bad transactions, bad configuration, abort, abandonment, timeout or invalid values.NetworkException
: Any communication error from Transbank Server, like network timeouts or wrong endpoints.ServerException
: Any internal Transbank error.UnknownException
: Any other error.
Exceptions are not logged.
Run examples locally
Licence
The MIT License (MIT). Please see License File for more information.
Redcompra
, Webpay
, Oneclick
, Onepay
, Patpass
and Transbank
are trademarks of Transbank S.A.. This package and its author are not associated with Transbank S.A.
All versions of transbank with dependencies
ext-json Version *
psr/http-client Version 1.*
psr/log Version 1.*|2.*|3.*
psr/event-dispatcher Version 1.*
nyholm/psr7 Version ^1.4