PHPackages swipegames/integration-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. [API Development](/categories/api) 4. / 5. swipegames/integration-sdk ActiveLibrary[API Development](/categories/api) swipegames/integration-sdk ========================== PHP SDK for Swipe Games platform integration 1.0.0(1mo ago)00[1 PRs](https://github.com/SwipeGames/integration-sdk-php/pulls)proprietaryPHPPHP ^8.1CI passing Since Mar 17Pushed 1mo agoCompare [ Source](https://github.com/SwipeGames/integration-sdk-php)[ Packagist](https://packagist.org/packages/swipegames/integration-sdk)[ RSS](/packages/swipegames-integration-sdk/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (4)Versions (3)Used By (0) Swipe Games PHP Integration SDK =============================== [](#swipe-games-php-integration-sdk) PHP SDK for integrating with the Swipe Games platform. Requirements ------------ [](#requirements) - PHP 8.1+ - Guzzle 7.x Installation ------------ [](#installation) ``` composer require swipegames/integration-sdk ``` Quick Start ----------- [](#quick-start) ``` use SwipeGames\SDK\SwipeGamesClient; use SwipeGames\SDK\Client\ClientConfig; $client = new SwipeGamesClient(new ClientConfig( cid: 'your-client-id', extCid: 'your-external-client-id', apiKey: 'your-api-key', integrationApiKey: 'your-integration-api-key', env: 'staging', // or 'production' )); ``` Configuration ------------- [](#configuration) ``` use SwipeGames\SDK\Client\ClientConfig; $config = new ClientConfig( cid: 'your-client-id', // SwipeGames-assigned client ID extCid: 'your-external-id', // Your external client ID apiKey: 'your-api-key', // Signs outbound Core API requests integrationApiKey: 'your-key', // Verifies inbound reverse calls env: 'staging', // 'staging' (default) or 'production' baseUrl: null, // Custom URL (overrides env) debug: false, // Enable debug logging logger: $psrLogger, // PSR-3 LoggerInterface timeout: 10, // HTTP timeout in seconds ); ``` ### Environments [](#environments) EnvironmentURL`staging``https://staging.platform.0.swipegames.io/api/v1``production``https://prod.platform.1.swipegames.io/api/v1`Core API -------- [](#core-api) ### Create New Game [](#create-new-game) ``` use SwipeGames\PublicApi\Core\CreateNewGameResponse; $result = $client->createNewGame([ 'gameID' => 'sg_catch_97', 'demo' => false, 'platform' => 'desktop', // 'desktop' or 'mobile' 'currency' => 'USD', 'locale' => 'en_us', 'sessionID' => 'your-session-id', // optional 'returnURL' => 'https://your-site.com', // optional 'depositURL' => 'https://deposit.url', // optional 'initDemoBalance' => '5000', // optional (demo only) 'user' => [ // optional 'id' => 'player-123', 'firstName' => 'John', ], ]); // $result is a CreateNewGameResponse object $result->getGameUrl(); // redirect player here $result->getGsId(); // game session ID ``` ### Get Games [](#get-games) ``` use SwipeGames\PublicApi\Core\GameInfo; /** @var GameInfo[] $games */ $games = $client->getGames(); foreach ($games as $game) { echo $game->getId() . ': ' . $game->getTitle() . "\n"; // $game->getCurrencies(), $game->getLocales(), $game->getPlatforms() // $game->getImages()->getSquare(), $game->getHasFreeSpins(), $game->getRtp() } ``` ### Create Free Rounds [](#create-free-rounds) ``` use SwipeGames\PublicApi\Core\CreateFreeRoundsResponse; $result = $client->createFreeRounds([ 'extID' => 'my-campaign-001', 'currency' => 'USD', 'quantity' => 10, 'betLine' => 1, 'validFrom' => '2026-01-01T00:00:00.000Z', 'gameIDs' => ['sg_catch_97'], // optional 'userIDs' => ['player-123'], // optional 'validUntil' => '2026-02-01T00:00:00.000Z', // optional ]); // $result is a CreateFreeRoundsResponse object $result->getId(); // internal campaign ID $result->getExtId(); // your external ID ``` ### Cancel Free Rounds [](#cancel-free-rounds) ``` // By internal ID $client->cancelFreeRounds(['id' => 'campaign-uuid']); // By external ID $client->cancelFreeRounds(['extID' => 'my-campaign-001']); ``` Integration Adapter ------------------- [](#integration-adapter) Implement these endpoints on your side to handle reverse calls from the platform. > **Important:** The platform enforces a **5-second timeout** on all integration adapter calls. If your endpoint does not respond in time, the platform will send a refund for bet requests and retry win/refund requests until a 200 response is received. ### Parse and Verify Requests [](#parse-and-verify-requests) The SDK verifies signatures, validates request bodies, and returns typed objects in one step: ``` use SwipeGames\PublicApi\Integration\BetRequest; // In your /bet endpoint handler $rawBody = file_get_contents('php://input'); $signature = $_SERVER['HTTP_X_REQUEST_SIGN'] ?? null; $result = $client->parseAndVerifyBetRequest($rawBody, $signature); if (!$result->ok) { http_response_code(401); echo json_encode($result->error); return; } /** @var BetRequest $betRequest */ $betRequest = $result->body; $betRequest->getType(); // 'regular' or 'free' $betRequest->getSessionId(); // game session ID $betRequest->getAmount(); // bet amount $betRequest->getTxId(); // transaction ID (idempotency key) $betRequest->getRoundId(); // round ID $betRequest->getFrId(); // free rounds ID (only for type='free') // Process the bet... ``` Available parse+verify methods: MethodRequest TypeReturns`parseAndVerifyBetRequest($body, $sig)`POST /bet`ParsedResult``parseAndVerifyWinRequest($body, $sig)`POST /win`ParsedResult``parseAndVerifyRefundRequest($body, $sig)`POST /refund`ParsedResult``parseAndVerifyBalanceRequest($queryParams, $sig)`GET /balance`ParsedResult` (pass `$_GET`)### Verify-Only Methods [](#verify-only-methods) If you only need signature verification: ``` $isValid = $client->verifyBetRequest($rawBody, $signature); $isValid = $client->verifyWinRequest($rawBody, $signature); $isValid = $client->verifyRefundRequest($rawBody, $signature); $isValid = $client->verifyBalanceRequest($_GET, $signature); ``` ### Response Builders [](#response-builders) Response builders return typed objects that are `JsonSerializable`: ``` use SwipeGames\SDK\Handler\ResponseBuilder; // Balance response — returns BalanceResponse object echo json_encode(ResponseBuilder::balanceResponse('100.50')); // {"balance":"100.50"} // Bet response — returns BetResponse object echo json_encode(ResponseBuilder::betResponse('90.50', 'your-tx-id')); // {"balance":"90.50","txID":"your-tx-id"} // Win response — returns WinResponse object echo json_encode(ResponseBuilder::winResponse('150.50', 'your-tx-id')); // Refund response — returns RefundResponse object echo json_encode(ResponseBuilder::refundResponse('100.50', 'your-tx-id')); // Error response — returns ErrorResponseWithCodeAndAction object echo json_encode(ResponseBuilder::errorResponse( message: 'Insufficient funds', code: 'insufficient_funds', // optional action: 'refresh', // optional actionData: 'some-data', // optional details: 'Balance is 0', // optional )); ``` Types ----- [](#types) All API types are generated from OpenAPI specs and provided by the `swipegames/public-api` package: NamespaceTypes`SwipeGames\PublicApi\Common``ErrorResponse`, `User``SwipeGames\PublicApi\Core``CreateNewGameRequest`, `CreateNewGameResponse`, `CreateFreeRoundsRequest`, `CreateFreeRoundsResponse`, `DeleteFreeRoundsRequest`, `GameInfo`, `GameInfoImages`, `BetLineInfo`, `BetLineValue`, `PlatformType``SwipeGames\PublicApi\Integration``BetRequest`, `WinRequest`, `RefundRequest`, `BalanceResponse`, `BetResponse`, `WinResponse`, `RefundResponse`, `ErrorResponseWithCodeAndAction`Error Handling -------------- [](#error-handling) ``` use SwipeGames\SDK\Exception\SwipeGamesApiException; use SwipeGames\SDK\Exception\SwipeGamesValidationException; try { $result = $client->createNewGame([...]); } catch (SwipeGamesApiException $e) { // API returned an error or a network error occurred echo $e->statusCode; // HTTP status (0 for network errors) echo $e->errorCode; // Error code (optional) echo $e->details; // Details (optional) } catch (SwipeGamesValidationException $e) { // Request parameters failed validation echo $e->getMessage(); } ``` ### Error Codes [](#error-codes) CodeDescription`game_not_found`Game ID not found`currency_not_supported`Currency not supported`locale_not_supported`Locale not supported`account_blocked`Player account blocked`bet_limit`Bet limit exceeded`loss_limit`Loss limit exceeded`time_limit`Time limit exceeded`insufficient_funds`Insufficient balance`session_expired`Game session expired`session_not_found`Game session not found`client_connection_error`Connection error### Error Actions [](#error-actions) ActionDescription`refresh`Show refresh button to playerDebug Logging ------------- [](#debug-logging) Enable debug logging with a PSR-3 logger: ``` use Monolog\Logger; use Monolog\Handler\StreamHandler; $logger = new Logger('swipegames'); $logger->pushHandler(new StreamHandler('php://stderr')); $client = new SwipeGamesClient(new ClientConfig( // ... debug: true, logger: $logger, )); ``` All log messages are prefixed with `[SwipeGamesSDK]`. Development ----------- [](#development) ``` composer install vendor/bin/phpunit ``` ### Health Score 36 — LowBetter than 82% of packages Maintenance89 Actively maintained with recent releases Popularity0 Limited adoption so far Community8 Small or concentrated contributor base Maturity43 Maturing project, gaining track record Bus Factor1 Top contributor holds 84.6% 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 Unknown Total 1 Last Release 53d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/c1feae566d4462fc5c6367f16aec24c8d6d7073f3431b8620862acbc038a1923?d=identicon)[swipegames](/maintainers/swipegames) --- Top Contributors [![Mirthis](https://avatars.githubusercontent.com/u/490732?v=4)](https://github.com/Mirthis "Mirthis (11 commits)")[![kvvit](https://avatars.githubusercontent.com/u/42875838?v=4)](https://github.com/kvvit "kvvit (2 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/swipegames-integration-sdk/health.svg) ``` [![Health](https://phpackages.com/badges/swipegames-integration-sdk/health.svg)](https://phpackages.com/packages/swipegames-integration-sdk) ``` ### Alternatives [sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M647](/packages/sylius-sylius)[theodo-group/llphant LLPhant is a library to help you build Generative AI applications. 1.5k311.5k5](/packages/theodo-group-llphant)[wheelpros/fitment-platform-api Magento 2 (Open Source) 12.1k1.2k](/packages/wheelpros-fitment-platform-api)[alexacrm/dynamics-webapi-toolkit Web API toolkit for Microsoft Dynamics 365 and Dynamics CRM 81324.1k1](/packages/alexacrm-dynamics-webapi-toolkit)[commercetools/commercetools-sdk The official PHP SDK for the commercetools Composable Commerce APIs 19281.5k](/packages/commercetools-commercetools-sdk)[keboola/storage-api-client Keboola Storage API PHP Client 10387.5k25](/packages/keboola-storage-api-client) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)