Collect Pledge Payments
Goal: Move money against a pledge — by check, online payment, or staff-recorded — so balance, donor record, and accounting all stay in sync.
Pledge payments are not auto-charged
Worth saying first: Ayuna does not auto-charge pledge installments. Each payment is initiated either by the donor (paying online via a pledge payment link) or by staff (recording a check or processing a card on the donor's behalf). If you want the schedule to be hands-off, pair the pledge with a Recurring Donation.
Three ways payments come in
1. Donor self-pays online
The donor uses their pledge payment page (/my-pledges/:pledgeId when logged in, or a public link for guests). They:
- See the next installment due and the amount
- Pay with a saved card, new card, or ACH
- Receive an immediate receipt
Behind the scenes, this creates a Donation record, marks the installment paid, and updates pledge balance and donor stats.
2. Staff records a payment received
When a check arrives in the mail or a donor calls in:
- Open the pledge detail
- Click Record Payment on the next installment
- Capture amount, date, payment method, payment notes
- Save
The payment becomes a Donation record and the installment moves to paid. If the amount is less than the installment's due amount, status moves to partial.
3. Staff processes a card on behalf of the donor
Useful when a donor calls in to pay by phone:
- Open the pledge
- Process Pledge Payment with their card details
- The transaction goes through Finix; on success, the same downstream effects as the other paths happen
Card-on-file from a previous gift can also be reused for this — pick from the donor's saved instruments instead of re-entering.
What happens when an installment is paid
For each successful payment:
- A Donation row is created with
pledge_idandpledge_installment_numberset - The pledge_payment row is updated (paid_date, status, donation_id)
- The pledge's
amount_paidandbalance_remainingrecalculate - A receipt is generated and emailed (per donor's preferences)
- The donor's lifetime giving, donation count, and giving level update
- The journal entry posts: debit Cash, credit Pledge Receivable
Partial payments
A donor can pay less than the full installment amount. The installment stays in partial status until topped up. Common reasons:
- Donor splits an installment over a few smaller payments for cash-flow reasons
- Mid-installment refund or adjustment
- A combined check covers multiple installments unevenly
Reminders
Ayuna doesn't send automatic dunning notices for past-due pledge payments. For affiliates with active pledges:
- Run the pledge stats report monthly to surface pending and overdue installments
- Send a templated reminder email or call the donor
- Update the pledge notes with what was discussed
Pledge completion
When the final installment is paid and balance reaches zero, the pledge moves to Completed. Send a thank-you specific to fulfillment of the pledge — this is a different moment than thanking for any individual payment.
When a payment is wrong
- Wrong amount — Edit Donation on the donation record; pledge balance recalculates
- Wrong installment selected — Edit Donation to point at the correct installment number
- Refund needed — see Refund a Donation; the pledge installment status returns to its prior state