> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rescueconsole.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adoption payments

> An adoption's ledger: recording payments and deposits, taking the fee online, refunds, paying another way, and a donation on top.

Each adoption keeps its own money on the **Ledger** tab of its record: what it costs, what has been paid and what is still owed. Open an adoption from the [adoptions list](https://docs.rescueconsole.com/animals/adoptions.md). Recording payments needs **Change** on Animals.

## The ledger

The **Ledger** tab starts with the money:

| Figure | What it means |
| - | - |
| **Fee** | What the adoption costs. |
| **Paid** | Verified payments, less verified refunds. |
| **Pending** | Recorded but not verified. Shown, **Not counted**. |
| **Balance** | Fee less Paid. **Settled** at zero. Reads **Overpaid**, **Refund owed**, when more was paid than the fee. |
| **Donation** | A gift on top of the fee, when there is one. Never part of the balance. |

> [!NOTE]
>
> Recorded is not received. A payment counts toward the balance only once somebody verifies it: confirms the money actually arrived. A check handed over, or a promise to pay, stays **Recorded** until then.

### Payments

Every payment and refund, newest first, with its amount (a refund with a minus), method, reference, the day received, and its state:

| State | What it means |
| - | - |
| **Recorded** | Entered, not yet confirmed. Not counted. |
| **Verified** | Confirmed as arrived. Counted. |
| **Voided** | Canceled, with the reason shown. Not counted. |

* **Verify** marks a recorded payment as arrived, by you, now.
* **Void** asks **Why is this being voided?** and then **Void payment**. The payment stays on the ledger, struck through with its reason, and stops counting. A void cannot be undone.

Nothing on the ledger is ever deleted.

### Record a payment

For money taken in person, by check, by bank transfer, or through any processor.

| Field | What it means |
| - | - |
| **Amount** | Required, more than zero. |
| **Method** | Cash, Check, Card, Bank transfer, Online, Other. |
| **Reference** | A check number, the last four digits, a receipt id. |
| **Received on** | The day the money came in. Today to begin with. |
| **Processor** | If it came through Stripe, Square, Zeffy, PayPal, Venmo, Cash App or another processor. **None** otherwise. |
| **Processor's id** | Asked once you choose a processor: the processor's own id for the charge or payment. This is what [reconciliation](https://docs.rescueconsole.com/animals/reconciliation.md) matches on. |
| **Drawer** | For cash or a check, once you have [cash drawers](https://docs.rescueconsole.com/settings/departments-tax-and-drawers.md#cash-drawers): the drawer it went into, so the day's count includes it. **None** for money that went into no drawer. |

**1. Choose payment or refund**

Choose **Payment** or **Refund**. A refund is recorded as a refund, never as a negative payment.

**2. Say whether it arrived**

Tick **I have confirmed this money arrived** only when it has. Leave it unticked for a check or a promise to pay: it will show as recorded, not paid, until someone verifies it.

**3. Record it**

Press **Record payment** (or **Record refund**).

The form is there while the adoption is in progress. On a reversed adoption it takes a refund and nothing else, because that is where a reversal leads; the choice between payment and refund is not offered. Once an adoption is finalized, no new payments or refunds can be recorded, though a payment already on the ledger can still be verified or voided.

### Deposits

A deposit the adopter left toward an adoption, taken over the counter on [Sales](https://docs.rescueconsole.com/fundraising/sales.md#deposits), comes off the fee. Under **Deposits** on the adoption, each deposit on file from the adopter has **Take it off the fee**: the fee is lowered by it, so the balance is what is still owed. The deposit is then redeemed. **Take it off** puts the fee back up and makes the deposit outstanding again.

A deposit comes off the fee only while the adoption is in progress, never for more than the fee, and never so far that the fee would be less than what has been paid already: then give the deposit back from its own sale instead. Finalizing fixes the fee, with any deposits on it.

## Taking payment online

**Pay online** sends the adopter a link to pay the balance by card. It needs your organization to have connected Stripe under **Settings → Finance & adoption → Payments**; see [Finance settings](https://docs.rescueconsole.com/settings/finance.md).

Press **Make a payment link**. The link appears once, for the balance owed at that moment: "send it however you talk to them". **Copy** puts it on your clipboard.

Or press **Email a link to** and the adopter's address, when they have one on file. The same link is made and emailed to them from your organization, and kept on their emails; the card says "emailed to" the address, and still shows the link to copy. If the email cannot be sent, the card says why, and the link is there to send another way.

An adopter who signed the contract from home, on a contract that says they pay **Card, with a payment link**, is taken straight on to paying; see [Signing from home](https://docs.rescueconsole.com/animals/application-contract.md#signing-from-home). That link is listed here like any other.

When the adopter pays, the payment appears on the ledger straight away: method Online, processor Stripe, with Stripe's id, and **Verified**, because Stripe has confirmed the money. A gift they add is recorded as a donation in Fundraising.

Every link made for the adoption is listed with what became of it:

| Says | What it means |
| - | - |
| **Not paid yet** | Sent, not used. |
| **Paid** | Paid, and on the ledger. |
| **Expired** | Can no longer be used. The reason is shown. |
| **Paid on Stripe, not recorded** | The adopter paid, but the adoption had changed and the payment could not go on the ledger. The money is in your Stripe account. Look at the reason and record what needs recording. |

A link is refused before any money is taken if, by the time the adopter goes to pay, the adoption has been reversed, the fee has already been paid, or the balance has dropped below the link's amount. Make a new link if the balance changed. While a link is still unpaid, the button reads **Make a new link**.

### What the adopter sees

The link opens a page on your public site headed **Adoption fee for** the animal's name, greeting the adopter by first name when it has one. It says how much is due to your organization, then:

* **Add a gift on top? Optional.**: **No thanks**, which is chosen to begin with, your donation amounts (see [Finance settings](https://docs.rescueconsole.com/settings/finance.md)), or **Or another amount**.
* A box to add about 3% to cover card processing, if your settings give the payer that choice, or a line saying it is added, if your settings add it.
* A line for any other fee your payment settings pass on to the payer.
* A **Pay** button with the amount. "You will finish on Stripe's secure page. We never see your card."

After paying they land on a **Thank you** page: their adoption fee has been received, with their gift if they gave one. "Stripe will email you a receipt." A button takes them back to your site.

A link that cannot be used says so instead: **Already paid**, **This link can no longer be used** with the reason, or **This link has expired** with "Ask the rescue for a fresh link." If your organization is not taking payments online, the page says **Not taking payments online yet** and asks them to pay you directly.

## Refunding a card payment

**Refund a card payment** appears under the ledger once a card payment has gone through, whatever state the adoption is in: reversed and finalized are the two states a refund most often follows.

Each card payment is listed with what was charged and what has already gone back.

**1. Start the refund**

Press **Refund**.

**2. Check the amount**

Check the amount (it starts at everything still refundable).

**3. Send the money back**

Add a reason if you want one on the ledger, then **Send the money back**.

* The amount is **what the card was charged**, not the fee. A gift the adopter added, the card processing they covered and any platform fee all rode on the same charge, and that total is what is on their statement.
* You can send back part of it. Type a smaller amount.
* Refunding **cannot be undone** from here.
* The refund appears on the ledger above as a refund, verified, when Stripe confirms it. That is usually immediate, and can take a few days on a bank payment. Until then the card says **Refund on its way**.

### What happens to the platform fee

Once **the whole charge** has been refunded, the platform fee on it comes back to you as well, and the adoption goes back in front of that month's billing, where a reversed adoption is billed to nobody and one that still stands is billed as usual.

Refunding **part of it** leaves the platform fee where it is. The animal went home, so the adoption happened.

It is the charge that decides, not any one refund: two part refunds that add up to the whole payment get the fee back exactly as one full refund does. The card says which of the two is about to happen before you press the button.

### A refund you made in Stripe

You do not have to refund from here. A refund made in your own Stripe dashboard is picked up and recorded on the ledger the same way, marked **made in Stripe** so it is clear nobody in RescueConsole did it. The platform fee is treated the same too, because the question asked is about the charge and not about who pressed what.

This is the half that matters most. Before it, a refund made in Stripe and not written down by hand left this record saying the adopter had paid.

> [!NOTE]
>
> A payment that says **Paid on Stripe, not recorded** cannot be refunded from here, because it never reached the ledger. Refund it in Stripe, and sort out the ledger separately.

## Pay another way

For an adopter paying with an app they already have. **Pay another way** shows a code to scan for each payment app your organization set up under **Settings → Finance & adoption → Payments** (Cash App, Venmo, PayPal, Zelle), with the balance already in it, and the handle under it. Zelle has no code: it lives inside banking apps, so the card shows the address to send to. Any other way you set up has no code either; read the details out, or show the screen.

> [!WARNING]
>
> These payments go straight to your own account, so RescueConsole is never told when one is paid. When the money lands, record it on the ledger the way you would record cash.

With no payment apps set up, the card says where to add them.

## A donation on top

**Add a donation** records a gift the adopter gives on top of the fee. Type the amount and press **Add donation**. It is recorded as a donation in Fundraising, separate from the fee and never part of the balance, and the adopter is marked as a donor. One donation can be added per adoption; after that the card shows it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.