conedevelopment/simplepay-php

The SimplePay PHP Client.

v0.1.1 2025-08-04 09:57 UTC

Requires

• php: ^8.1
• ext-curl: *
• ext-json: *
• ext-mbstring: *
• guzzlehttp/guzzle: ^7.3
• guzzlehttp/psr7: ^2.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.5

MIT

• Cone Development
• Szépe Viktor

• php
• api
• payment
• sdk
• openapi
• SimplePay
• otpmobil

README

Provides an OpenAPI schema and an auto-generated PHP client as a Composer package.

SimplePay is a payment gateway provided by OTP Mobil Kft.

Warning

This is not an official package.

Requirements

• PHP 8.1+
• Curl, JSON, Multibyte String extensions

Installation

composer require conedevelopment/simplepay-php

Configuration

• SimplePay Merchant ID
• SimplePay Secret Key

Usage

$client = new Cone\SimplePay\Client('MERCHANT', 'SECRET_KEY');

$client->api()->start(...);
$client->api()->finish(...);
$client->api()->refund(...);
$client->api()->query(...);
$client->api()->do(...);
$client->api()->transactionCancel(...);
$client->api()->doRecurring(...);
$client->api()->cardQuery(...);
$client->api()->cardCancel(...);
$client->api()->tokenQuery(...);
$client->api()->tokenCancel(...);
$client->api()->startEam(...);
$client->api()->startApplePay(...);
$client->api()->doApplePay(...);

Note

The client automatically adds the merchant, salt and sdkVersion parameters to the body as well as the Signature header to the request.

Error Handling

SimplePay responds with HTTP 200 even if the operation has failed or an error has occured. To handle this properly the Client has a built-in middleware that checks whether the response contains any errors, if so, it throws an ApiException.

The message holds the error code and the error message to make debugging easier.

use Cone\SimplePay\ApiException;

try {
    $client->api()->start(...);
} catch (ApiException $exception) {
    // Log the message starting with the error code
    Log::info($exception->getMessage());

    // Log the error code only
    Log::info($exception->getCode());
}