payu/fx-client

FX API PHP 客户端

v0.1.0 2018-06-19 10:26 UTC

This package is auto-updated.

Last update: 2024-09-09 23:30:18 UTC


README

Build Status

FX API PHP 客户端

简介

这是一个访问 FX API 的 HTTP 客户端的 PHP 实现。

安装

您可以使用 composer 安装客户端

composer require payu/fx-client-php:^1.0

您至少需要 PHP 5.6,并启用支持 HTTPS 的 cURL。

使用方法

首先,您需要提供您的账户商户代码和密钥。为此,创建一个 \PayU\FX\Config\MerchantCredentials 配置实例

<?php

use PayU\FX\Config\MerchantCredentials;

require_once 'vendor/autoload.php';

$config = new MerchantCredentials(
    'MY_CODE',
    'MY_SECRET_KEY'
);

接下来,通过提供上述配置实例和您将要使用的平台/国家(可能的值:Platform::RO()Platform::TR()Platform::RU())创建 API 客户端

<?php

use PayU\FX\Client;
use PayU\FX\Config\MerchantCredentials;
use PayU\FX\Config\Platform;

require_once 'vendor/autoload.php';

$config = new MerchantCredentials(
    'MY_CODE',
    'MY_SECRET_KEY'
);

$platform = Platform::RO();

$client = new Client($config, $platform);

FX 客户端的每个方法都会抛出 PayU\FX\Exceptions\ClientException 异常,如果某些操作不符合预期。例如

<?php

use PayU\FX\Client;
use PayU\FX\Config\MerchantCredentials;
use PayU\FX\Config\Platform;
use PayU\FX\Exceptions\ClientException;


require_once 'vendor/autoload.php';

$config = new MerchantCredentials(
    'MY_CODE',
    'MY_SECRET_KEY'
);

$platform = Platform::RO();

$client = new Client($config, $platform);

try {
    $client->getAllFxRates('RON');
} catch (ClientException $e) {
    echo $e->getMessage();
}

更多示例代码可以在 examples 目录中找到。

许可证

此库采用 Apache-2.0 许可证。请参阅 LICENSE 文件。