README

此库是用 PHP 编写的非官方 Digiflazz API。

• 文档
• 安装
• 使用
• 方法签名和示例
  • 余额
    • 获取余额
  • 价格列表
    • 获取价格列表
  • 存款
    • 创建存款凭证
  • 交易
    • 创建交易
    • 查询后付费
    • 支付后付费
    • 查询 PLN
  • 回调
    • 获取回调
• 异常
  • InvalidArgumentException
  • ApiException
• 贡献

文档

有关 API 文档，请参阅Digiflazz API 参考文档。

安装

使用以下命令使用 composer 安装 digiflazz-php-library

composer require nurfaizfy/digiflazz-php-library

或者在您的 composer.json 文件中手动添加。

使用

使用从 Digiflazz 控制台 获取的账户密钥配置包。

use Gonon\Digiflazz\Digiflazz;
Digiflazz::initDigiflazz('username', 'apikey');

方法签名和示例

余额

获取余额

\Gonon\Digiflazz\Balance::getBalance();

使用示例

$getBalance = \Gonon\Digiflazz\Balance::getBalance();
var_dump($getBalance);

价格列表

获取价格列表

\Gonon\Digiflazz\PriceList::getPrePaid(); // Prepaid product
\Gonon\Digiflazz\PriceList::getPostPaid(); // Postpaid product

使用示例

$priceList = \Gonon\Digiflazz\PriceList::getPrePaid();
var_dump($priceList);

存款

创建存款凭证

\Gonon\Digiflazz\Deposit::createDeposit(array $params);

此方法的参数

使用示例

$params = [
    'amount' => '200000',
    'bank' => 'BCA',
    'owner_name' => 'Digiflazz',
];
$createDeposit = \Gonon\Digiflazz\Deposit::createDeposit($params);
var_dump($createDeposit);

交易

创建交易

\Gonon\Digiflazz\Transaction::createTransaction(array $params);

此方法的参数

使用示例

$params = [
    'buyer_sku_code' => 'xl10',
    'customer_no' => '08123456789',
    'ref_id' => 'some1d',
];
$createTrasaction = \Gonon\Digiflazz\Transaction::createTransaction($params);
var_dump($createTrasaction);

查询后付费

\Gonon\Digiflazz\Transaction::inquiryPostpaid(array $params);

此方法的参数

使用示例

$params = [
    'buyer_sku_code' => 'xl10',
    'customer_no' => '08123456789',
    'ref_id' => 'some1d',
];
$pascaInquiry = \Gonon\Digiflazz\Transaction::inquiryPostpaid($params);
var_dump($pascaInquiry);

支付后付费

\Gonon\Digiflazz\Transaction::payPostpaid(array $params);

此方法的参数

使用示例

$params = [
    'buyer_sku_code' => 'xl10',
    'customer_no' => '08123456789',
    'ref_id' => 'some1d',
];
$payPasca = \Gonon\Digiflazz\Transaction::payPostpaid($params);
var_dump($payPasca);

查询 PLN

\Gonon\Digiflazz\Transaction::inquiryPLN(array $params);

此方法的参数

使用示例

$params = [
    'customer_no' => '123456789',
];
$iquiryPLN = \Gonon\Digiflazz\Transaction::inquiryPLN($params);
var_dump($iquiryPLN);

回调

获取回调

使用此方法获取回调

\Gonon\Digiflazz\Callback::getCallback();

使用此方法获取 JSON 回调

\Gonon\Digiflazz\Callback::getJsonCallback();

异常

InvalidArgumentException

如果用户提供的参数不足以创建请求，将抛出 InvalidArgumentException。

例如，创建交易时需要一些必需的参数，如 ref_id、customer_no 和 buyer_sku_code。如果用户在尝试创建交易时缺少一个或多个参数，将抛出 InvalidArgumentException。

InvalidArgumentException 是从 PHP 的 InvalidArgumentException 衍生的。有关此异常方法和属性的更多信息，请参阅PHP 文档。

ApiException

ApiException 包装了 Digiflazz API 错误。如果 Digiflazz API 端有错误，将抛出此异常。

获取异常消息

try {
    $transaction = \Gonon\Digiflazz\Transaction::createTransaction(array $params);
} catch (\Gonon\Digiflazz\Exceptions\ApiException $e) {
    var_dump($e->getMessage());
}

获取异常 HTTP 错误代码

try {
    $transaction = \Gonon\Digiflazz\Transaction::createTransaction(array $params);
} catch (\Gonon\Digiflazz\Exceptions\ApiException $e) {
    var_dump($e->getCode());
}

获取异常 Digiflazz API 错误代码

try {
    $transaction = \Gonon\Digiflazz\Transaction::createTransaction(array $params);
} catch (\Gonon\Digiflazz\Exceptions\ApiException $e) {
    var_dump($e->getErrorCode());
}

贡献

有关任何请求、错误或评论，请提交问题

安装包

在开始编码之前，运行此命令以安装所有必需的包。请确保您的计算机已安装 composer

composer install

有一个预提交钩子用于运行 phpcs 和 phpcbf。请在提交/推送之前确保它们通过了。