Settings - Money

Refund authorization

Review the gate that allows refunds only from approved calculations or authorized manual reasons before any Stripe refund can be planned.

Otto Fixture BPPE Career School - Refund authorization proof

School Administrator · Sam Director

Only approved calculations or authorized manual reasons pass

This page proves the staff gate before any Stripe refund can be planned. It checks the original payment, remaining refundable amount, connected account, authorization source, and blocked fund categories before showing a preview-only refund request.

Back to payments Review request preview

RFD-2026-0001

$125.00

Approved calculation for Maya Torres

Preview only

Original payment

Refunds return to the source payment

Stripe Connect test

Payment

PAY-2026-0002

Receipt

RCT-2026-0002

Captured

$325.00

Remaining

$325.00

Connected account

acct_test_bppe_career_001

Stripe charge

ch_test_otto_october_installment_001

Mode

Test

Blocked funds

None

RFD-2026-0001

Approved calculation lane

Authorized

Amount

$125.00

Reason code

withdrawal

Authorization

Approved calculation

Approver

finance_admin

Calculation key

bppe-withdrawal-calc-2026-10-12-v1

Manual reason

Not used

RFD-2026-0002

Manual authorization lane

Authorized

Amount

$25.00

Reason code

duplicate_payment

Authorization

Authorized manual reason

Approver

bursar_manager

Calculation key

Not used

Manual reason

Duplicate card authorization captured during local test payment retry.

Stripe Refund API preview

Request shape without execution

No API call

Endpoint

POST /v1/refunds

Stripe-Account

acct_test_bppe_career_001

Charge

ch_test_otto_october_installment_001

Amount

12500

Stripe reason

requested_by_customer

Execution

preview_only

Idempotency-Key

otto:11111111-1111-4111-8111-111111111111:refund:rfd-2026-0001

Metadata

{
  "tenant_id": "11111111-1111-4111-8111-111111111111",
  "student_id": "11111111-1111-4111-8111-111111111112",
  "enrollment_id": "11111111-1111-4111-8111-111111111113",
  "payment_id": "11111111-1111-4111-8111-111111111115",
  "refund_number": "RFD-2026-0001",
  "authorization_kind": "approved_calculation",
  "approved_calculation_key": "bppe-withdrawal-calc-2026-10-12-v1"
}

Ledger preview

Refund journal reverses the payment

Balanced

No.AccountDebitCredit

11100 - Student receivableRFD-2026-0001 - reverse payment against student account$125.00-

21030 - Stripe clearingRFD-2026-0001 - cash leaves Stripe clearing-$125.00

Total$125.00$125.00

Refund row shape

The existing tenant-owned refunds table already carries the authorization fields this gate uses.

payment_id

student_id

enrollment_id

refund_number

amount_cents

reason_code

authorization_kind

approved_calculation_key

manual_reason

approved_by_membership_id

stripe_refund_id

Safety blocks

Unsafe refunds do not plan

5 blocked

Missing approved calculation

The refund calculation must be approved.

Manual reason missing

Manual authorized refunds require a written reason.

Over remaining amount

Refund amount $500.00 exceeds the remaining refundable $325.00.

Blocked funds category

Title IV funds, credit balances, and loan proceeds cannot move through this Stripe refund flow.

Live-mode request

Live-mode refunds are blocked in this proof.

Boundary

Only Stripe Connect test payments can reach refund planning in this proof.
A refund must come from an approved calculation key or an authorized manual reason with an approver.
Title IV funds, credit balances, loan proceeds, live-mode requests, provider events, and non-Stripe payments stay blocked.
Payer-paid card fee refund behavior remains off until card-fee review gates define final fee rules and ledger treatment.
The page previews the Stripe Refund API request and balanced ledger journal, but it does not call Stripe or persist refund rows.