README

Laravel 包，用于通过 Bui Corporation API 集成支付。

安装

先决条件

请确保已安装 Composer 和 Laravel。

安装步骤

通过 Composer 添加包 :

composer require bui-corporation/bui-payment

发布配置文件 :

php artisan vendor:publish --provider="Bui\\Payment\\BuiPaymentServiceProvider"

添加环境变量 到您的 .env 文件

BUI_API_KEY=your_api_key_here
BUI_BASE_URL=https://api.buicorporation.io/v1.0/

配置

发布配置文件后，您可以在 config/buipayment.php 中找到它。您可以在其中设置默认参数。

使用

获取服务列表

您可以使用 BuiPayment 门面获取可用服务的列表。

use Bui\Payment\Facades\BuiPayment;

$services = BuiPayment::getServices();
use Bui\Payment\Facades\BuiPayment;

## Effectuer un paiement

$paymentData = [
    'paymentMethod' => 'mobile_money',
    'mobileMoney' => [
        'service' => 'PAYIN_ORANGE_CI',
        'amount' => 200,
        'recipient' => '+225XXXXXXXXXX',
        'reference' => 'unique_reference',
        'note' => 'Transaction note',
        'otpCode' => '123456',
    ],
    'customer' => [
        'firstname' => 'John',
        'lastname' => 'Doe',
        'email' => 'john.doe@example.com',
        'externalId' => '123456',
        'phoneNumber' => '+225XXXXXXXXXX'
    ]
];

检查支付状态

use Bui\Payment\Facades\BuiPayment;
$status = BuiPayment::getPaymentStatus('payment_id_here');

### Effectuer un transfert
use Bui\Payment\Facades\BuiPayment;

$transferData = [
    'transferMethod' => 'mobile_money',
    'mobileMoney' => [
        'service' => 'PAYOUT_ORANGE_CI',
        'amount' => 200,
        'recipient' => '+225XXXXXXXXXX',
        'reference' => 'unique_reference',
        'note' => 'Transaction note'
    ],
    'customer' => [
        'firstname' => 'John',
        'lastname' => 'Doe',
        'email' => 'john.doe@example.com',
        'externalId' => '123456',
        'phoneNumber' => '+225XXXXXXXXXX'
    ]
];
$transfer = BuiPayment::makeTransfer($transferData);

检查转账状态

use Bui\Payment\Facades\BuiPayment;

$status = BuiPayment::getTransferStatus('transfer_id_here');

管理钱包

获取钱包列表

use Bui\Payment\Facades\BuiPayment;

$wallets = BuiPayment::getWallets();

获取钱包余额

use Bui\Payment\Facades\BuiPayment;

$balance = BuiPayment::getWalletBalance('wallet_id_here');

执行 payin（给钱包充值）

use Bui\Payment\Facades\BuiPayment;

$payinData = [
    'amount' => 1000,
    'walletId' => 'wallet_id_here'
];
$payin = BuiPayment::payin($payinData);

执行 payout（从钱包扣款）

use Bui\Payment\Facades\BuiPayment;

$payoutData = [
    'amount' => 500,
    'walletId' => 'wallet_id_here'
];
$payout = BuiPayment::payout($payoutData);

贡献

欢迎贡献。为了提出改进，请打开一个问题或提交一个 pull request。

bui-corporation / bui-payment

维护者

详细信息