README

Hyperwallet REST SDK（支持Guzzle 7）

一个用于通过Hyperwallet v4 API管理用户、转账方式和支付的库。

对于Hyperwallet v3 API调用，请使用最新版本的SDK 1.x.x。请参阅[此处|https://docs.hyperwallet.com/content/updates/v1/rest-api-v4]了解版本之间的差异以及使用REST API v4所需的更新过程。

先决条件

Hyperwallet的PHP服务器SDK至少需要PHP 5.6及以上版本。

安装

$ composer require hyperwallet/sdk

文档

文档可在http://hyperwallet.github.io/php-sdk找到。

API概述

使用SDK编写应用程序

• 在Hyperwallet程序门户注册沙盒账户，并获取您的用户名、密码和程序令牌。

• 将依赖项hyperwallet/sdk添加到您的composer.json中。

• 创建Hyperwallet客户端实例（包含用户名、密码和程序令牌）

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

• 开始进行API调用（例如创建用户）

  $user = new \Hyperwallet\Model\User();
  $user
    ->setClientUserId('test-client-id-1')
    ->setProfileType(\Hyperwallet\Model\User::PROFILE_TYPE_INDIVIDUAL)
    ->setFirstName('Daffyd')
    ->setLastName('y Goliath')
    ->setEmail('testmail-1@hyperwallet.com')
    ->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
  }

• 错误处理HyperwalletException包含一个具有code、message和field属性的错误数组，以表示错误。

    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";
      }
    }

开发

使用phpunit运行测试

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

参考

REST API参考

许可

MIT