AS1024/itflow
1
0
Fork 0
mirror of https://github.com/itflow-org/itflow synced 2026-08-05 07:07:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Backed out of Refunds which still keeps the fix to properly set the invoice status when payment is deleted

Browse Source
This commit is contained in:
johnnyq
2026-07-28 22:03:35 -04:00
parent 31921ee99b
commit 1494d2cb5e
4 changed files with 11 additions and 512 deletions
Download Patch File Download Diff File Expand all files Collapse all files

68
functions/payments.php
View File

@@ -1,76 +1,14 @@
<?php
/*
* ITFlow - Payment & refund helpers
*
* Refunds are stored in the payments table as negative rows, linked back to the
* payment they reverse via payment_refund_of_id. Every balance calculation in the
* app is a SUM(payment_amount), so a negative row reduces the invoice's amount
* paid and the account balance without any of those call sites needing to change.
* ITFlow - Payment helpers
*/
/**
* Total amount already refunded against a single payment (returned positive).
*/
function getPaymentRefundedTotal($payment_id)
{
global $mysqli;
$payment_id = intval($payment_id);
$sql = mysqli_query($mysqli, "SELECT SUM(payment_amount) AS refunded FROM payments WHERE payment_refund_of_id = $payment_id");
$row = mysqli_fetch_assoc($sql);
return abs(floatval($row['refunded']));
}
/**
* How much of a payment can still be refunded.
*/
function getPaymentRefundableAmount($payment_id)
{
global $mysqli;
$payment_id = intval($payment_id);
$sql = mysqli_query($mysqli, "SELECT payment_amount, payment_refund_of_id FROM payments WHERE payment_id = $payment_id LIMIT 1");
$row = mysqli_fetch_assoc($sql);
if (!$row || !is_null($row['payment_refund_of_id'])) {
return 0.00;
}
$payment_amount = floatval($row['payment_amount']);
if ($payment_amount <= 0) {
return 0.00;
}
return round($payment_amount - getPaymentRefundedTotal($payment_id), 2);
}
/**
* Pull the Stripe PaymentIntent ID out of a payment reference.
*
* All four Stripe booking sites write 'Stripe - pi_xxx' into payment_reference,
* which is the only place the PI is recorded. Returns null for anything else,
* which is how a manually entered payment is identified as non-refundable via Stripe.
*/
function getStripePaymentIntentId($payment_reference)
{
if (preg_match('/^Stripe - (pi_[A-Za-z0-9]+)$/', trim($payment_reference), $matches)) {
return $matches[1];
}
return null;
}
/**
* Recalculate and store an invoice's status from the sum of its payments.
*
* Refund rows are negative, so an invoice that is refunded in full drops back to
* Sent rather than being stranded on Partial. Draft and Cancelled invoices are
* left alone - those states are not a function of the payment total.
* Draft and Cancelled invoices are left alone - those states are not a function
* of the payment total.
*/
function updateInvoiceStatusFromPayments($invoice_id)
{