mediacube/hyperwallet-sdk

A library to manage users, transfer methods and payments through the Hyperwallet API

v3.1 2024-11-19 16:44 UTC

Requires

• php: >=5.6.0
• ext-json: *
• gree/jose: ^2.2.1
• guzzlehttp/guzzle: ^6.2.1 || ^7.0.1
• phpseclib/phpseclib: ^2.0.11

Requires (Dev)

• phake/phake: ^2.3 || ^4.2
• php-coveralls/php-coveralls: ^2.5
• phpunit/phpunit: ^5.7 || ^7.0.0 || ^9.0

MIT

• Mediacube team

• rest
• sdk
• ach
• creditcard
• bankaccount
• payout
• hyperwallet

README

Hyperwallet REST SDK 1.7.3

A library to manage users, transfer methods and payments through the Hyperwallet v3 API.

Version 2.0.0 and higher are for use with Hyperwallet v4 API only. See [here|https://docs.hyperwallet.com/content/updates/v1/rest-api-v4] to learn about the differences between versions and the update process required to use REST API v4.

Prerequisites

Hyperwallet's PHP server SDK requires at minimum PHP 5.6 and above.

Installation

$ composer require mediacube/hyperwallet-sdk

Documentation

Documentation is available at http://hyperwallet.github.io/php-sdk.

API Overview

To write an app using the SDK

• Register for a sandbox account and get your username, password and program token at the Hyperwallet Program Portal.

• Add dependency hyperwallet/sdk to your composer.json.

• Create a instance of the Hyperwallet Client (with username, password and program token)

  $client = new \Hyperwallet\Hyperwallet("restapiuser@4917301618", "mySecurePassword!", "prg-645fc30d-83ed-476c-a412-32c82738a20e");

• Start making API calls (e.g. create a user)

  $user = new \Hyperwallet\Model\User();
  $user
    ->setClientUserId('test-client-id-1')
    ->setProfileType(\Hyperwallet\Model\User::PROFILE_TYPE_INDIVIDUAL)
    ->setFirstName('Daffyd')
    ->setLastName('y Goliath')
    ->setEmail('[e-mail]')
    ->setAddressLine1('123 Main Street')
    ->setCity('Austin')
    ->setStateProvince('TX')
    ->setCountry('US')
    ->setPostalCode('78701');
  
  try {
      $createdUser = $client->createUser($user);
  } catch (\Hyperwallet\Exception\HyperwalletException $e) {
      // Add error handling here
  }

• Error Handling The HyperwalletException has an array of errors with code, message and fielName properties to represent a error.

    try {
      ... 
    } catch (\Hyperwallet\Exception\HyperwalletException $e) {
      // var_dump($e->getErrorResponse());
      // var_dump($e->getErrorResponse()->getErrors());
      foreach ($e->getErrorResponse()->getErrors() as $error) {
          echo "\n------\n";
          echo $error->getFieldName()."\n";
          echo $error->getCode()."\n";
          echo $error->getMessage()."\n";
      }
    }

Development

Run the tests using phpunit:

$ composer install
$ ./vendor/bin/phpunit -v

Reference

REST API Reference

License

MIT