README

API documentation HU | API documentation EN

Support chart

Installation

composer require connorhu/khvpos

Symfony Bundle

There is no Flex recipe — bundle registration is manual.

Register the bundle

// config/bundles.php
return [
    KHTools\VPos\Bundle\KHVPosBundle::class => ['all' => true],
];

Configuration

# config/packages/khvpos.yaml
khvpos:
    test: true   # set to false for production
    merchants:
        default:
            merchant_id: '%env(KHVPOS_MERCHANT_ID)%'
            private_key_path: '%kernel.project_dir%/config/keys/merchant.pem'
            private_key_passphrase: '%env(KHVPOS_PRIVATE_KEY_PASSPHRASE)%'  # optional, default ''
            currency: HUF

A single VPosClient service is registered as khvpos.vpos_client (also autowirable as VPosClient). Inject MerchantProviderInterface to look up the correct merchant by currency:

use KHTools\VPos\Bundle\Providers\MerchantProviderInterface;
use KHTools\VPos\Requests\PaymentInitRequest;
use KHTools\VPos\VPosClient;

public function __construct(
    private VPosClient $client,
    private MerchantProviderInterface $merchantProvider,
) {}

public function pay(): void
{
    $merchant = $this->merchantProvider->getMerchant('HUF');
    $request = new PaymentInitRequest();
    $request->setMerchant($merchant);
    // ...
}

Multiple merchants (multiple currencies)

khvpos:
    test: false
    merchants:
        huf:
            merchant_id: '%env(KHVPOS_HUF_MERCHANT_ID)%'
            private_key_path: '%kernel.project_dir%/config/keys/huf.pem'
            currency: HUF
        eur:
            merchant_id: '%env(KHVPOS_EUR_MERCHANT_ID)%'
            private_key_path: '%kernel.project_dir%/config/keys/eur.pem'
            currency: EUR

$merchantProvider->getMerchant('EUR') returns the EUR merchant.

All configuration options

Payum Integration

Requires payum/core ^1.7. For Symfony, also install payum/payum-bundle:

composer require payum/payum-bundle

With payum/payum-bundle installed and a khvpos: config block present, the khvpos Payum gateway is registered automatically — no extra YAML required:

$gateway = $payum->getGateway('khvpos');
$gateway->execute(new Capture($payment));

The first configured merchant is used. Supported Payum requests: Capture, Authorize, Refund, Cancel, Sync, GetHumanStatus, Convert.