README

Yapikredi (Posnet) gateway for the Omnipay PHP payment processing library.

Omnipay is a framework agnostic, multi-gateway payment processing library for PHP. This package implements Yapikredi (Posnet) support for Omnipay.

Installation

composer require tcgunel/omnipay-yapikredi

Requirements

• PHP >= 8.0
• ext-simplexml
• ext-dom

Supported Methods

Not Implemented

The following features are not available through the CP.VPOS Posnet integration:

• Cancel/Refund: Not supported (returns error). Use the Yapikredi merchant panel instead.
• Sale Query: Not supported through this API.
• Installment/BIN Query: Not available through Posnet.

Credentials

Endpoints

Test panel: https://setmpos.ykb.com/PosnetF1/Login.jsp

Usage

Non-3D Direct Sale (purchase)

use Omnipay\Omnipay;

$gateway = Omnipay::create('Yapikredi');

$gateway->setMerchantId('6706598320');
$gateway->setTerminalId('67005551');
$gateway->setPosnetId('1010028724');
$gateway->setTestMode(true);

$response = $gateway->purchase([
    'amount'        => '1.50',
    'currency'      => 'TRY',
    'transactionId' => 'ORDER-001',
    'installment'   => 1,
    'card'          => [
        'number'      => '4506349116608409',
        'expiryMonth' => '03',
        'expiryYear'  => '2030',
        'cvv'         => '000',
    ],
])->send();

if ($response->isSuccessful()) {
    echo "Transaction Reference: " . $response->getTransactionReference();
} else {
    echo "Error: " . $response->getMessage();
    echo "Code: " . $response->getCode();
}

3D Secure Payment (enrolment + completePurchase)

Step 1: Enrolment (redirect to 3D page)

$response = $gateway->enrolment([
    'amount'        => '1.50',
    'currency'      => 'TRY',
    'transactionId' => 'ORDER-001',
    'installment'   => 1,
    'returnUrl'     => 'https://example.com/payment/callback',
    'storeKey'      => '10,10,10,10,10,10,10,10',
    'card'          => [
        'number'      => '4506349116608409',
        'expiryMonth' => '03',
        'expiryYear'  => '2030',
        'cvv'         => '000',
    ],
])->send();

if ($response->isRedirect()) {
    $response->redirect(); // Redirects to 3D Secure page
} else {
    echo "Error: " . $response->getMessage();
}

Step 2: Complete Purchase (after 3D callback)

// In your callback URL handler:
$response = $gateway->completePurchase([
    'amount'         => '1.50',
    'currency'       => 'TRY',
    'transactionId'  => 'ORDER-001',
    'storeKey'       => '10,10,10,10,10,10,10,10',
    'bankPacket'     => $_POST['BankPacket'],
    'merchantPacket' => $_POST['MerchantPacket'],
    'sign'           => $_POST['Sign'],
])->send();

if ($response->isSuccessful()) {
    echo "Payment successful!";
    echo "Transaction Reference: " . $response->getTransactionReference();
} else {
    echo "Payment failed: " . $response->getMessage();
}

Posnet Protocol Notes

• Amount Format: Multiplied by 100, no decimals (e.g., 1.50 TRY = "150")
• Currency Codes: TRY = "TL", USD = "US", EUR = "EU"
• Order ID: Padded with leading zeros to 24 characters
• Expiry Date: YYMM format (e.g., March 2030 = "3003")
• Installment: "00" for single payment, "02"-"12" for installments
• 3D Secure Hash: SHA256 based. First hash: SHA256(storeKey + ";" + terminalId), MAC: SHA256(xid + ";" + amount + ";" + currency + ";" + mid + ";" + firstHash)

Testing

composer test

License

MIT License. See LICENSE for details.