simpaypl / simpay
Official SimPay API
Installs: 1 441
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 2
Forks: 0
Open Issues: 1
Requires
- php: ^7.4 || ^8.0
- ext-curl: *
- ext-json: *
- ext-mbstring: *
- guzzlehttp/guzzle: ^7.3
- guzzlehttp/psr7: ^1.7 || ^2.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.5
- pedrotroller/php-cs-custom-fixer: ^2.28
- phpstan/phpstan: ^1.10
- phpunit/phpunit: ^8.0 || ^9.0
- rector/rector: ^0.19.0
- symplify/easy-coding-standard: *
README
Description
This documentation is intended for current and future Simpay Partners. Prior to implementation, it is necessary to define the service in the Partner Panel and wait for its activation directly from the operators.
Installation & Usage
Requirements
PHP 7.4 and later. Should also work with PHP 8.0.
Composer
To install run composer require simpaypl/simpay
Manual Installation
Download the files and include autoload.php
:
<?php require_once('/prject/path/vendor/autoload.php');
Getting Started
<?php require_once(__DIR__ . '/vendor/autoload.php'); $configuration = new Configuration('your_api_key', 'your_api_password', 'en'); $client = new Client([ 'base_uri' => Configuration::API_BASE_URI, ]); $api = new Simpay\DirectBillingApi( // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`. // This is optional, `GuzzleHttp\Client` will be used as default. $client, $config ); try { $result = $api->directBillingGetServices(); print_r($result); } catch (\Exception $e) { echo 'Exception when calling DirectBillingApi->directbillingGetServices: ', $e->getMessage(), PHP_EOL; }
Examples
All examples are in the examples directory.
Documentation for API Endpoints
API Endpoints
All URIs are relative to https://api.simpay.pl
- Configuration
- DirectBillingApi
- DirectBillingCalculateApi
- DirectBillingTransactionApi
- HttpClientFactory
- PaymentApi
- SmsNumberApi
- SmsServiceApi
- SmsTransactionApi
Models
Requests:
- Amount
- AmountType
- Billing
- CallbackReturnUrl
- CartItem
- Channel
- ChannelType
- Control
- CreatePayment
- Currency
- Customer
- Description
- DirectBillingTransaction
- DirectBillingTransactionStatus
- DirectChannel
- Filters
- Operator
- PaymentTransactionId
- PhoneNumber
- Referer
- ServiceId
- ServiceNumber
- Shipping
- SmsCode
- SmsNumber
- SmsTransactionId
- StreamId
Responses:
- Amount
- AmountType
- CallbackReturnUrl
- DirectBillingTransaction
- DirectBillingTransactionCollection
- DirectBillingTransactionList
- DirectBillingTransactionNotify
- Operator
- Pagination
- PaginationLinks
- PaymentChannel
- PaymentChannelCollection
- PaymentCreate
- PaymentService
- PaymentServiceCollection
- PaymentServiceTransaction
- PaymentServiceTransactionCollection
- PaymentServiceTransactionStatus
- PaymentServiceTransaction
- PaymentServiceTransactionAddress
- PaymentServiceTransactionAmount
- PaymentServiceTransactionCartItems
- PaymentServiceTransactionCustomer
- PaymentServiceTransactionRedirect
- Service
- ServiceCalculation
- ServiceCalculationOperatorAmount
- ServiceCollection
- ServiceNumber
- ServiceStatus
- ServiceType
- SmsNumber
- SmsNumberCollection
- SmsService
- SmsServiceCheckCodeData
- SmsServiceCollection
- SmsTransaction
- SmsTransactionCollection
Exceptions:
- Simpay\Exception\ExceptionFactory
- Simpay\Exception\Forbidden
- Simpay\Exception\InternalServerError
- Simpay\Exception\NotFound
- Simpay\Exception\Unauthorized
- Simpay\Exception\Unknown
- Simpay\Exception\UnprocessableEntity
All the exceptions have the getErrors
method which returns an array of errors returned by the API.
Tests
To run the tests, use:
composer install bin/phpunit
Docker
To build the Docker image:
make build
To run the Docker image:
make up
Enter the container (bash):
make bash
To run the tests:
make test
To run the linter:
make lint
About this package
- API version:
1.0.0