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

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