genome/merchant

Genome merchant client libraries

0.0.4 2025-11-25 08:03 UTC

Requires (Dev)

• php: ^7.2||^8.0
• phpunit/phpunit: ^8.0

MIT

README

Genome merchant account client library.

Easy start

Initialize merchant account manager using merchant account identifier and secret.

use Genome\Merchant\MerchantAccountManager;

$merchantAccountLogin = "foo";  // Your merchant account login
$merchantAccountSecret = "baz"; // Your merchant account password

$accountManager = new MerchantAccountManager($merchantAccountLogin, $merchantAccountSecret);

Then obtain hosted payment page manager from merchant account manager by providing hosted payment page api key and secret (they differ from merchant account ones).

$hppApiKey = 'xxx';
$hppApiSecret = 'yyy';

$hppManager = $accountManager->getHostedPaymentPageManager($hppApiKey, $hppApiSecret)

Verify hosted payment page callback signature

try {
    $hppManager->assertCallbackSignature(getallheaders(), file_get_contents('php://input'));
} catch (\Exception e) {
    // Signature assertion failed
}

Or initialize new payment redirect using HostedPayment:

$payment = new HostedPayment(
    "uniqueOrderId",
    "userId",
    "mcc",
    "eur",
    9.99
);

$redirectUrl = $hppManager->generateInitializationRedirectUrl($payment); 

The HostedPayment is a mutable object containing payment data, it provides setters for additional parameters like email, phone, etc.