README

安装

composer require quetzal-studio/laravel-flip

FLIP_ENV=sandbox // or production
FLIP_CLIENT_KEY=YOUR_FLIP_CLIENT_KEY

示例用法

use QuetzalStudio\Flip\Flip;

try {
    Flip::balance();
} catch (\Illuminate\Http\Client\RequestException $e) {
    // handle request exception
} catch (\Exception $e) {
    // handle exception
}

获取余额

Flip::balance();

获取维护状态

Flip::balance();

获取银行

Flip::banks();

获取国家

Flip::countries();

获取城市

Flip::cities();

获取支付

对于参数，您可以在https://docs.flip.id/#get-all-disbursement-v3中查看详细信息。

Flip::getDisbursements();

Flip::getDisbursements(['page' => 2]);

查找支付

默认情况下，将根据idempotency-key查找

Flip::findDisbursement('KEY1002');

Flip::findDisbursement('10', 'id');

银行账户查询

$account = \QuetzalStudio\Flip\Factories\BankAccountInquiryFactory::make([
    "account_number" => "1122333301",
    "bank_code" => "bni",
    "inquiry_key" => \Illuminate\Support\Str::random(8),
]);

Flip::bankAccountInquiry($account);

创建货币转账/创建支付

$payload = \QuetzalStudio\Flip\Factories\MoneyTransferFactory::make([
    'account_number' => '1122333300',
    'bank_code' => 'bni',
    'amount' => '10000',
    'remark' => 'some remark',
    'recipient_city' => '391',
    'beneficiary_email' => 'test@mail.com,user@mail.com'
]);

Flip::moneyTransfer($idempotencyKey = 'KEY1000', $payload);

创建特殊货币转账/创建特殊支付

$payload = \QuetzalStudio\Flip\Factories\SpecialMoneyTransferFactory::make([
    'account_number' => '1122333301',
    'bank_code' => 'bni',
    'amount' => '10000',
    'remark' => 'some remark',
    'recipient_city' => '391',
    'sender_country' => 100252,
    'sender_place_of_birth' => 391,
    'sender_date_of_birth' => '1992-01-01',
    'sender_identity_type' => 'nat_id',
    'sender_name' => 'John Doe',
    'sender_address' => 'Some Address Street 123',
    'sender_identity_number' => '123456789',
    'sender_job' => 'entrepreneur',
    'direction' => 'DOMESTIC_SPECIAL_TRANSFER',
    'beneficiary_email' => 'test@mail.com,user@mail.com'
]);

Flip::specialMoneyTransfer($idempotencyKey = 'KEY1000', $payload);

备注

默认情况下，所有API都会返回实际数据（int，bool，array），如果请求出错，将抛出异常。

需要HTTP响应吗？

Flip::useHttpResponse();

try {
    Flip::balance(); // return Illuminate\Http\Client\Response
} catch (\Illuminate\Http\Client\RequestException $e) {
    // handle request exception
} catch (\Exception $e) {
    // handle exception
}

禁用抛出异常

Flip::disableThrow();

Flip::balance();