PHPackages raiffeisen-ecom/payment-sdk - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Payment Processing](/categories/payments) 4. / 5. raiffeisen-ecom/payment-sdk ActiveLibrary[Payment Processing](/categories/payments) raiffeisen-ecom/payment-sdk =========================== Ecommerce payment API SDK v1.1.55(3y ago)250.4k↓67.6%1[1 issues](https://github.com/Raiffeisen-DGTL/ecom-sdk-php/issues)2MITPHPPHP >=5.6.0 Since May 6Pushed 3y ago3 watchersCompare [ Source](https://github.com/Raiffeisen-DGTL/ecom-sdk-php)[ Packagist](https://packagist.org/packages/raiffeisen-ecom/payment-sdk)[ Docs](https://github.com/Raiffeisen-DGTL/ecom-sdk-php)[ RSS](/packages/raiffeisen-ecom-payment-sdk/feed)WikiDiscussions main Synced 3d ago READMEChangelogDependencies (4)Versions (8)Used By (2) Ecommerce payment API SDK ========================= [](#ecommerce-payment-api-sdk) [![Build Status](https://github.com/Raiffeisen-DGTL/ecom-sdk-php/actions/workflows/ci.yaml/badge.svg)](https://github.com/Raiffeisen-DGTL/ecom-sdk-php/actions/workflows/ci.yaml)[![Latest Stable Version](https://camo.githubusercontent.com/6f57355c136d3435f52fbdafbda50e6d77f4893b2bafc3692309d3d195fca95f/68747470733a2f2f706f7365722e707567782e6f72672f7261696666656973656e2d65636f6d2f7061796d656e742d73646b2f76657273696f6e)](https://packagist.org/packages/raiffeisen-ecom/payment-sdk)[![Total Downloads](https://camo.githubusercontent.com/0f29fe0e1cb687ddeaf76c5f654687d2398a49bb4bcf7129612922c25bfbd21b/68747470733a2f2f706f7365722e707567782e6f72672f7261696666656973656e2d65636f6d2f7061796d656e742d73646b2f646f776e6c6f616473)](https://packagist.org/packages/raiffeisen-ecom/payment-sdk) SDK модуль для внедрения эквайринга Райффайзенбанка. Установка и подключение ----------------------- [](#установка-и-подключение) Установка с помощью [composer](https://getcomposer.org/download/): ``` $ composer require raiffeisen-ecom/payment-sdk ``` Документация ------------ [](#документация) \*\*Raiffeisenbank e-commerce API: Генерация авто-документации `composer run docs`. Клиент API ---------- [](#клиент-api) Для использования SDK требуется секретный ключ `$secretKey` и идентификатор мерчанта `$publicId`, подробности [в документации](https://pay.raif.ru/doc/ecom.html#section/API/Avtorizaciya) и на [сайте банка](https://www.raiffeisen.ru/corporate/management/commerce/). ``` ``` Параметры конструктора и свойства клиента: - `$secretKey` - секретный ключ, обязательный, доступ только на запись; - `$publicId` - идентификатор мерчанта, обязательный, доступ на чтение и запись; - `$host` - хост api, по умолчанию `https://e-commerce.raiffeisen.ru`, доступ на чтение и запись; - `$options` - дополнительные [параметры запроса](https://www.php.net/manual/en/function.curl-setopt.php), доступ только на чтение. Примеры ------- [](#примеры) Пользователь совершает следующие действия в процессе платежа: - Выбирает товары/услуги в корзину магазина и нажимает кнопку “Оплатить”; - Партнер открывает платежную форму; - Клиент вводит реквизиты на платежной форме и подтверждает платеж. ### Настройка URL для приема событий [](#настройка-url-для-приема-событий) Метод `postCallbackUrl` устанавливает адресс приема событий. В параметрах нужно указать: - `$callbackUrl` - невый URL. ``` ``` ### Платежная форма [](#платежная-форма) Метод `getPayUrl` возвращает ссылку на платежную форму. В параметрах нужно указать: - `$amount` - сумма заказа; - `$orderId` - идентификатор заказа; - `$query` - дополнительные параметры запроса. ``` ``` Вывод: ``` https://e-commerce.raiffeisen.ru/pay/?publicId=***&amount=10&orderId=testOrder&successUrl=http%3A%2F%2Ftest.ru%2F ``` ### Получение информации о статусе транзакции [](#получение-информации-о-статусе-транзакции) Метод `getOrderTransaction` возвращает информацию о статусе транзакции. В параметрах нужно указать: - `$orderId` - идентификатор заказа. ``` ``` Вывод: ``` Array ( [code] => SUCCESS [transaction] => Array ( [id] => 120059 [orderId] => testOrder [status] => Array ( [value] => SUCCESS [date] => 2019-07-11T17:45:13+03:00 ) [paymentMethod] => acquiring [paymentParams] => Array ( [rrn] => 935014591810 [authCode] => 25984 ) [amount] => 12500.5 [comment] => Покупка шоколадного торта [extra] => Array ( [additionalInfo] => Sweet Cake ) ) ) ``` ### Оформление возврата по платежу [](#оформление-возврата-по-платежу) Метод `postOrderRefund` создает возврат по заказу. В параметрах нужно указать: - `$orderId` - идентификатор заказа; - `$refundId` - идентификатор заказа; - `$amount` - сумма возврата. ``` ``` Вывод: ``` Array ( [code] => SUCCESS [amount] => 150 [refundStatus] => IN_PROGRESS ) ``` ### Статус возврата [](#статус-возврата) Метод `getOrderRefund` возвращает статус возврата. В параметрах нужно указать: - `$orderId` - идентификатор заказа; - `$refundId` - идентификатор заказа. ``` ``` Вывод: ``` Array ( [code] => SUCCESS [amount] => 150 [refundStatus] => COMPLETED ) ``` ### Получение информации о заказе [](#получение-информации-о-заказе) Метод `getOrder` возвращает данные о заказе. В параметрах нужно указать: - `$orderId` - идентификатор заказа. ``` ``` Вывод: ``` Array ( [amount] => 12500.5 [comment] => Покупка шоколадного торт [extra] => Array ( [additionalInfo] => sweet cake ) [status] => Array ( [value] => NEW [date] => 2019-08-24T14:15:22+03:00 ) [expirationDate] => 2019-08-24T14:15:22+03:00 ) ``` ### Отмена выставленного заказа [](#отмена-выставленного-заказа) Метод `deleteOrder` удаляет заказ, если он не был оплачен. В параметрах нужно указать: - `$orderId` - идентификатор заказа. ``` ``` ### Получение списка чеков [](#получение-списка-чеков) Метод `getOrderReceipts` возвращает список чеков. В параметрах нужно указать: - `$orderId` - идентификатор заказа. - `$receiptType` - необязательное, тип чека: - sell – чек прихода; - refund – чек возврата. ``` ``` Вывод: ``` Array ( [0] => Array ( [receiptNumber] => 3000827351831 [receiptType] => REFUND [status] => DONE [orderNumber] => testOrder [total] => 1200 [customer] => Array ( [email] => customer@test.ru [name] => Иванов Иван Иванович ) [items] => Array ( [0] => Array ( [name] => Шоколадный торт [price] => 1200 [quantity] => 1 [amount] => 1200 [paymentObject] => COMMODITY [paymentMode] => FULL_PREPAYMENT [measurementUnit] => шт [nomenclatureCode] => 00 00 00 01 00 21 FA 41 00 23 05 41 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 12 00 AB 00 [vatType] => VAT20 [agentType] => ANOTHER [supplierInfo] => Array ( [phone] => +79991234567 [name] => ООО «Ромашка» [inn] => 1234567890 ) ) ) ) ) ``` ### Получение чека возврата [](#получение-чека-возврата) Метод `getOrderRefundReceipt` возвращает чек возврата. В параметрах нужно указать: - `$orderId` - идентификатор заказа; - `$refundId` - идентификатор возврата. ``` ``` Вывод: ``` Array ( [receiptNumber] => 3000827351831 [receiptType] => REFUND [status] => DONE [orderNumber] => testOrder [total] => 1200 [customer] => Array ( [email] => customer@test.ru [name] => Иванов Иван Иванович ) [items] => Array ( [0] => Array ( [name] => Шоколадный торт [price] => 1200 [quantity] => 1 [amount] => 1200 [paymentObject] => COMMODITY [paymentMode] => FULL_PREPAYMENT [measurementUnit] => шт [nomenclatureCode] => 00 00 00 01 00 21 FA 41 00 23 05 41 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 12 00 AB 00 [vatType] => VAT20 [agentType] => ANOTHER [supplierInfo] => Array ( [phone] => +79991234567 [name] => ООО «Ромашка» [inn] => 1234567890 ) ) ) ) ``` ### Уведомление о платеже [](#уведомление-о-платеже) Метод `checkEventSignature` проверяет подпись уведомления о платеже. В параметрах нужно указать: - `$signature` - содержимое заголовка `x-api-signature-sha256`; - `$eventBody` - разобранный JSON из тела запроса. ``` ``` Требования ---------- [](#требования) - **PHP v5.6.0** или выше - расширение PHP **json** - расширение PHP **curl** Лицензия -------- [](#лицензия) [MIT](LICENSE) ### Health Score 29 — LowBetter than 57% of packages Maintenance10 Infrequent updates — may be unmaintained Popularity33 Limited adoption so far Community13 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~53 days Recently: every ~75 days Total 7 Last Release 1200d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/6245332d0fb89d8c7f8456db7ae5cca101fbe4cf9d5fc7c5abac4b354ece76c0?d=identicon)[user-ecom-packagist](/maintainers/user-ecom-packagist) --- Top Contributors [![user-ecom-git](https://avatars.githubusercontent.com/u/73883095?v=4)](https://github.com/user-ecom-git "user-ecom-git (2 commits)") ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/raiffeisen-ecom-payment-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/raiffeisen-ecom-payment-sdk/health.svg)](https://phpackages.com/packages/raiffeisen-ecom-payment-sdk) ``` ### Alternatives [msilabs/bkash bKash Payment Gateway API for Laravel Framework. 181.2k](/packages/msilabs-bkash)[binkode/laravel-paystack A description for laravel-paystack. 112.1k](/packages/binkode-laravel-paystack) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)