cego/seamless-wallet-client

This package is abandoned and no longer maintained. No replacement package was suggested.

Package for interacting with the seamless wallet service

0.6.2 2021-08-18 11:44 UTC

Requires

• php: ^7.4|^8.0
• ext-bcmath: *
• ext-json: *
• cego/service-client-base: ^0.1.9
• guzzlehttp/guzzle: ^6.5.5|^7.0.1
• illuminate/http: ^7.0|^8.0
• illuminate/support: ^7.0|^8.0
• nbj/property-container: ^1.4
• nesbot/carbon: ^2.42
• phpoption/phpoption: ^1.7
• vlucas/phpdotenv: ^5.2

Requires (Dev)

• cego/request-insurance: ^0.3.2
• friendsofphp/php-cs-fixer: ^2.16
• orchestra/testbench: ^6.13
• phpstan/phpstan: ^0.12
• phpunit/phpunit: ^9.0
• ramsey/uuid: ^4.1

Suggests

• cego/request-insurance: Allows for sending asynchronous requests

MIT

• Niki Ewald Zakariassen
• Nikolaj Boel Jensen

README

Project was initially created by:

• Niki Ewald Zakariassen (NIZA)
• Nikolaj Boel Jensen (NBJ)

Usage

The seamless wallet client implements a fluid interface for interacting with the seamless wallet service.

Interface

// Getting a client instance
$seamlessWallet = SeamlessWallet::create('base_url')
    ->auth(/* < Credentials > */);

// Setting the target player
$seamlessWallet->forPlayer($playerId);

// Creating a user wallet
SeamlessWallet::create(/* < Base Url > */)
    ->auth(/* < Credentials > */)
    ->forPlayer($playerId)
    ->createWallet();

// Deposits / withdraws / balance / rollback
SeamlessWallet::create(/* < Base Url > */)
    ->auth(/* < Credentials > */)
    ->forPlayer($playerId)
    ->deposit(100, "UUID6" /*, $transaction_context, $external_id */);

SeamlessWallet::create(/* < Base Url > */)
    ->auth(/* < Credentials > */)
    ->forPlayer($playerId)
    ->withdraw(20, "UUID6" /*, $transaction_context, $external_id */);

SeamlessWallet::create(/* < Base Url > */)
    ->auth(/* < Credentials > */)
    ->forPlayer($playerId)
    ->getBalance();

SeamlessWallet::create(/* < Base Url > */)
    ->auth(/* < Credentials > */)
    ->rollbackTransaction("UUID6");

// Using request insurance
SeamlessWallet::create(/* < Base Url > */)
    ->auth(/* < Credentials > */)
    ->useRequestInsurance()
    ->forPlayer($playerId)
    ->deposit(100, "UUID6" /*, $transaction_context, $external_id */);

_{Note: After calling ->forPlayer() the id is kept in memory for later use
Note: Request insurance is only usable for POST requests, and is remembered for following requests. GET requests will always use the synchronous HTTP driver}

Error Handling

The client does not use error return values, meaning if a request failed then an exception will be thrown: SeamlessWalletRequestFailedException.php.

The client has a configurable amount of retries on server errors, before throwing an exception.

• env("SEAMLESS_WALLET_CLIENT_MAXIMUM_NUMBER_OF_RETRIES")
• env("SEAMLESS_WALLET_CLIENT_TIMEOUT")