Skip to navigation
Gift Processing

Donation Status

A Donation’s payment_status tells you where the money is, regardless of how the gift was initiated.

ValueWhat it means
INCOMING_TO_CHARIOTThe funds are on their way into your Chariot account. Chariot usually matches them automatically and marks the gift RECEIVED_IN_CHARIOT once the deposit completes; a deposit Chariot cannot match is reconciled in the dashboard. Chariot emails you once the funds are available.
INCOMING_OUTSIDE_CHARIOTThe funds are on their way to you directly from the payer, so Chariot cannot see them land. Someone on your team marks the gift received in the dashboard, unless a connected source records the payment first.
RECEIVED_IN_CHARIOTThe funds arrived in your Chariot account.
RECEIVED_OUTSIDE_CHARIOTReceipt was confirmed outside Chariot, by you or by a connected source.
CANCELEDThe gift will not be paid.

Payment status is derived by Chariot from the state of the funds, so it is read only over the API.

Settlement Timestamps

A Donation can read as received before the money is usable. Check the timestamps when your workflow depends on funds being available.

FieldWhat it marks
created_atWhen Chariot created the Donation record.
settlement.settled_atWhen the deposit settled at the bank.
settlement.deposit_idThe Deposit the funds arrived in.

Retrieving Donations

Getting Started shows the List Donations and Get Donation calls. List Donations returns gifts across every connected payment source on the account, pages with next_page_token, which you pass back as page_token with the same filters, and caps the page size at 100. You can filter by payment_source_id, deposit_id, created_at.after, created_at.before, and dafpay_tracking_id.

Filtered by Creation Date

List Donations filters on created_at, not updated_at, so it will not show changes to older gifts. Pair it with donation.updated events.

Recording Your Own Status

Properties are the writable part of a Donation, and you retrieve them alongside the rest of the Donation data. To record your own status, for example that a gift has been entered in your CRM, create a property in the Chariot Dashboard and assign it to the Donation. The FAQ shows the call.