root
139 lines
4.0 KiB
PHP
139 lines
4.0 KiB
PHP
<?php
|
|
|
|
namespace App\Models;
|
|
|
|
use CodeIgniter\Model;
|
|
|
|
class PaymentTransactionModel extends Model
|
|
{
|
|
protected $table = 'payment_transactions'; // Table name
|
|
protected $primaryKey = 'id'; // Primary key
|
|
|
|
// Allowed fields for mass assignment
|
|
protected $allowedFields = [
|
|
'transaction_id',
|
|
'payment_id', // Reference to payments table (the associated payment)
|
|
'transaction_date',
|
|
'amount',
|
|
'payment_method',
|
|
'payment_status',
|
|
'transaction_fee',
|
|
'semester',
|
|
'school_year'
|
|
];
|
|
|
|
protected $useTimestamps = false;
|
|
|
|
// Validation rules
|
|
protected $validationRules = [
|
|
'transaction_id' => 'required|is_unique[payment_transactions.transaction_id]',
|
|
'payment_id' => 'required|integer', // Reference to payment table
|
|
'amount' => 'required|decimal',
|
|
'payment_method' => 'required|string|max_length[50]',
|
|
'payment_status' => 'required|string|max_length[50]',
|
|
'semester' => 'permit_empty|string|max_length[30]',
|
|
'school_year' => 'permit_empty|string|max_length[9]',
|
|
];
|
|
|
|
// Custom error messages
|
|
protected $validationMessages = [
|
|
'transaction_id' => [
|
|
'required' => 'The transaction ID is required.',
|
|
'is_unique' => 'The transaction ID must be unique.',
|
|
],
|
|
'payment_id' => [
|
|
'required' => 'The payment ID is required.',
|
|
'integer' => 'The payment ID must be an integer.',
|
|
],
|
|
'amount' => [
|
|
'required' => 'The payment amount is required.',
|
|
'decimal' => 'The payment amount must be a valid decimal number.',
|
|
],
|
|
'payment_method' => [
|
|
'required' => 'The payment method is required.',
|
|
'max_length' => 'The payment method must not exceed 50 characters.',
|
|
],
|
|
'payment_status' => [
|
|
'required' => 'The payment status is required.',
|
|
'max_length' => 'The payment status must not exceed 50 characters.',
|
|
],
|
|
];
|
|
|
|
/**
|
|
* Get all transactions for a specific payment.
|
|
*
|
|
* @param int $paymentId
|
|
* @return array
|
|
*/
|
|
public function getTransactionsByPaymentId($paymentId)
|
|
{
|
|
return $this->where('payment_id', $paymentId)
|
|
->orderBy('transaction_date', 'DESC')
|
|
->findAll();
|
|
}
|
|
|
|
/**
|
|
* Retrieve a single transaction by its transaction ID.
|
|
*
|
|
* @param string $transactionId
|
|
* @return array|null
|
|
*/
|
|
public function getTransactionById($transactionId)
|
|
{
|
|
return $this->where('transaction_id', $transactionId)->first();
|
|
}
|
|
|
|
/**
|
|
* Update payment status by transaction ID.
|
|
*
|
|
* @param string $transactionId
|
|
* @param string $status
|
|
* @return bool
|
|
*/
|
|
public function updateTransactionStatus($transactionId, $status)
|
|
{
|
|
return $this->where('transaction_id', $transactionId)
|
|
->set(['payment_status' => $status])
|
|
->update();
|
|
}
|
|
|
|
/**
|
|
* Get total amount paid for a specific payment.
|
|
*
|
|
* @param int $paymentId
|
|
* @return float
|
|
*/
|
|
public function getTotalPaidByPaymentId($paymentId)
|
|
{
|
|
$this->selectSum('amount');
|
|
return $this->where('payment_id', $paymentId)->get()->getRow()->amount;
|
|
}
|
|
|
|
/**
|
|
* Update transaction fee for a specific transaction.
|
|
*
|
|
* @param string $transactionId
|
|
* @param float $transactionFee
|
|
* @return bool
|
|
*/
|
|
public function updateTransactionFee($transactionId, $transactionFee)
|
|
{
|
|
return $this->where('transaction_id', $transactionId)
|
|
->set(['transaction_fee' => $transactionFee])
|
|
->update();
|
|
}
|
|
|
|
/**
|
|
* Get the latest payment transaction for a payment.
|
|
*
|
|
* @param int $paymentId
|
|
* @return array|null
|
|
*/
|
|
public function getLatestTransactionByPaymentId($paymentId)
|
|
{
|
|
return $this->where('payment_id', $paymentId)
|
|
->orderBy('transaction_date', 'DESC')
|
|
->first();
|
|
}
|
|
}
|