سرویس کیف پول

<?php
 
use Basalam\SDK\BasalamClient;
use Basalam\SDK\Auth\ClientCredentials;
 
$auth = new ClientCredentials(
    clientId: 'your-client-id',
    clientSecret: 'your-client-secret'
);
 
$client = new BasalamClient($auth);

<?php
 
use Basalam\SDK\Wallet\Models\BalanceFilter;
 
function getBalanceExample(): object
{
    global $client;
 
    $balance = $client->getBalance(
        userId: 123,
        filters: [
            new BalanceFilter(
                cash: true,
                settleable: true,
                vendor: false,
                customer: true
            )
        ]
    );
 
    return $balance;
}

<?php
 
function getTransactionsExample(): object
{
    global $client;
 
    $transactions = $client->getTransactions(
        userId: 123,
        page: 1,
        perPage: 20
    );
 
    foreach ($transactions->data as $transaction) {
        echo "Transaction: {$transaction->time} - Amount: {$transaction->amount}\n";
    }
 
    return $transactions;
}

<?php
 
use Basalam\SDK\Wallet\Models\SpendCreditRequest;
 
function createExpenseExample(): object
{
    global $client;
 
    $expense = $client->createExpense(
        userId: 123,
        request: new SpendCreditRequest(
            reasonId: 1,
            referenceId: 456,
            amount: 10000,
            description: 'Payment for order #456',
            types: [1, 2],
            settleable: true,
            references: [
                'order_id' => 456,
                'payment_method' => 1
            ]
        )
    );
 
    return $expense;
}

<?php
 
use Basalam\SDK\Wallet\Models\SpendSpecificCreditRequest;
 
function createExpenseFromCreditExample(): object
{
    global $client;
 
    $expense = $client->createExpenseFromCredit(
        userId: 123,
        creditId: 789,
        request: new SpendSpecificCreditRequest(
            reasonId: 1,
            referenceId: 456,
            amount: 5000,
            description: 'Payment from specific credit',
            settleable: true,
            references: [
                'order_id' => 456,
                'credit_type' => 1
            ]
        )
    );
 
    return $expense;
}

<?php
 
function getExpenseExample(): object
{
    global $client;
 
    $expense = $client->getExpense(
        userId: 123,
        expenseId: 456
    );
 
    return $expense;
}

<?php
 
function deleteExpenseExample(): object
{
    global $client;
 
    $result = $client->deleteExpense(
        userId: 123,
        expenseId: 456,
        rollbackReasonId: 2
    );
 
    return $result;
}

<?php
 
function getExpenseByRefExample(): ?object
{
    global $client;
 
    $expense = $client->getExpenseByRef(
        userId: 123,
        reasonId: 1,
        referenceId: 456
    );
 
    if ($expense) {
        echo "Found expense: {$expense->id}\n";
    }
 
    return $expense;
}

<?php
 
function deleteExpenseByRefExample(): object
{
    global $client;
 
    $result = $client->deleteExpenseByRef(
        userId: 123,
        reasonId: 1,
        referenceId: 456,
        rollbackReasonId: 2
    );
 
    return $result;
}

<?php
 
use Basalam\SDK\Wallet\Models\RefundRequest;
 
function createRefundExample(): object
{
    global $client;
 
    $refund = $client->createRefund(
        request: new RefundRequest(
            originalReason: 1,
            originalReferenceId: 456,
            reason: 2,
            referenceId: 789,
            amount: 5000,
            description: 'Refund for cancelled order',
            references: [
                [
                    'reference_type_id' => 1,
                    'reference_id' => 456
                ]
            ]
        )
    );
 
    return $refund;
}

<?php
 
function canRollbackRefundExample(): bool
{
    global $client;
 
    $canRollback = $client->canRollbackRefund(
        refundReason: 2,
        refundReferenceId: 789
    );
 
    return $canRollback;
}

<?php
 
use Basalam\SDK\Wallet\Models\RollbackRefundRequest;
 
function rollbackRefundExample(): object
{
    global $client;
 
    $result = $client->rollbackRefund(
        request: new RollbackRefundRequest(
            refundReason: 2,
            rollbackRefundReason: 3,
            refundReferenceId: 789,
            referenceId: 456,
            description: 'Rollback refund due to error',
            references: [
                [
                    'reference_type_id' => 1,
                    'reference_id' => 456
                ]
            ]
        )
    );
 
    return $result;
}