owlookit/tiptoppay-php-client

tiptoppay api client

0.0.3 2025-03-30 22:24 UTC

Requires

• php: >=8.0
• guzzlehttp/guzzle: ^7.4
• myclabs/php-enum: ^1.8
• psr/log: ^1 || ^2 || ^3

Requires (Dev)

• phpunit/phpunit: 9.5

MIT

• Ruslan Voroshchuk

• tiptoppay api
• tiptoppay

README

Оглавление

• Tiptoppay API Client
  • Оглавление
  • Предисловие
  • Установка
  • Начало работы
  • Поддерживаемые методы
  • Параметры запроса
  • Параметры ответа
  • Уведомления
  • Идемпотентность
  • License

Предисловие

• php 8.x support

Установка

composer require owlookit/tiptoppay-php-client

Начало работы

$publicId = /*...*/;
$pass = /*...*/;
$apiClient = new \Owlookit\Tiptoppay\Library($publicId, $pass);
$response = $apiClient->paymentsCardsCharge(new \Owlookit\Tiptoppay\Request\CardsPayment(
    100,
    'KZT',
    '123.123.123.123',
    '01492500008719030128SMfLeYdKp5dSQVIiO5l6ZCJiPdel4uDjdFTTz1UnXY'
));

echo $response->success;

Поддерживаемые методы

Библиотека поддерживает большое количество методов api(https://developers.tiptoppay.kz/#api). Для параметров запроса и ответа поддерживается объект-обертка.

$apiClient = new \Owlookit\Tiptoppay\Library(\*...*\);
$apiClient->paymentsCardsCharge(\*...*\);

Метод api	Метод library	Объект Request	Объект Response
payments/cards/charge	paymentsCardsCharge	TransactionWith3dsResponse	TransactionWith3dsResponse
payments/cards/auth	createPaymentByCard2Step	TransactionWith3dsResponse	TransactionWith3dsResponse
payments/tokens/charge	executePaymentByToken	TokenPayment	TransactionResponse
payments/tokens/auth	executePaymentByToken	TokenPayment	TransactionResponse
payments/confirm	confirmPayment	PaymentsConfirm	CloudResponse
payments/void	cancelPayment	PaymentsVoid	CloudResponse
payments/refund	paymentsRefund	PaymentsRefund	TransactionResponse
payments/cards/topup	paymentsCardsTopup	CardsTopUp	TransactionResponse
payments/token/topup	paymentsTokenTopup	TokenTopUp	TransactionResponse
payments/get	getPaymentData	PaymentsGet	TransactionResponse
payments/find	getPaymentDataByInvoice	PaymentsFind	TransactionResponse
payments/list	getListPayment	PaymentsList	TransactionArrayResponse
payments/tokens/list	paymentsTokensList	TokenList	TokenArrayResponse
subscriptions/create	subscriptionsCreate	SubscriptionCreate	SubscriptionResponse
subscriptions/get	subscriptionsGet	SubscriptionGet	SubscriptionResponse
subscriptions/find	subscriptionsFind	SubscriptionFind	SubscriptionArrayResponse
subscriptions/update	subscriptionsUpdate	SubscriptionUpdate	SubscriptionResponse
subscriptions/cancel	subscriptionsCancel	SubscriptionCancel	CloudResponse
orders/create	ordersCreate	OrderCreate	OrderResponse
orders/cancel	ordersCancel	OrderCancel	CloudResponse
site/notifications/{Type}/get	siteNotificationsGet	NotificationsGet	NotificationResponse
site/notifications/{Type}/update	siteNotificationsUpdate	NotificationsUpdate	CloudResponse
applepay/startsession	startSession	ApplepayStartSession	AppleSessionResponse

Параметры запроса

Параметры запроса обернуты в dto-объект

...
$validationUrl = 'https://apple-pay-gateway.apple.com/paymentservices/startSession';
$request = new \Owlookit\Tiptoppay\Request\ApplepayStartSession($validationUrl);
$apiClient->startSession($request);

Библиотека может выбрасывать ошибку BadTypeException при формировании request-объекта

try {
    ...
    $validationUrl = 'https://apple-pay-gateway.apple.com/paymentservices/startSession';
    $request = new \Owlookit\Tiptoppay\Request\ApplepayStartSession($validationUrl);
    ...
} catch (\Owlookit\Tiptoppay\Exceptions\BadTypeException $e) {
    var_dump($e->getMessage());
}

Параметры ответа

Параметры ответа так же обернуты в dto-объект. CloudResponse имеет 3 свойства: success, message, model

В свойство model записывается нужная сущность, в зависимости от запроса.

Список поддерживаемых сущностей:

• AppleSessionModel
• NotificationModel
• SubscriptionModel
• TokenModel
• TransactionModel
• TransactionWith3dsModel

Уведомления

Библиотека включает в себя dto-объекты для параметров веб хуков

$hookData = new \Owlookit\Tiptoppay\Hook\HookPay($_POST);
echo $hookData->transactionId;

Список всех уведомлений - https://developers.tiptoppay.kz/#check

Webhook	Объект
Check	HookCheck
Pay	HookPay
Fail	HookFail
Confirm	HookConfirm
Refund	HookRefund
Recurrent	HookRecurrent
Cancel	HookCancel

Идемпотентность

Библиотека поддерживает идемпотентные запросы

...
$apiClient = new \Owlookit\Tiptoppay\Library(\*...*\);
$apiClient->setIdempotency(true);
$apiClient->createPaymentByCard2Step(\*...*\);
...

License

MIT