> This page is for version v2026-04-01 (default).
> For other versions, use one of these documentation indexes:
> - v2026-04-01 (default): https://docs.givechariot.com/v2026-04-01/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.givechariot.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.givechariot.com/_mcp/server.

# Managing Gifts

## Flow of Funds

### Where DAFpay Funds Arrive

DAFpay submits the request but does not hold the donor's DAF funds. Funds are sent the way that provider normally pays. Timing varies by route and provider, from a few days to several weeks.

Gifts reach the nonprofit one of two ways:

| Route                                     | When it applies                                                                                                               | How the funds arrive                                        | Grant marked Completed                                        |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------- |
| Electronically to Chariot Deposit Account | The provider pays through one of Chariot's disbursement partners, or the nonprofit linked the provider to its Chariot account | Electronically into the nonprofit's Chariot Deposit Account | Automatically                                                 |
| Outside of Chariot                        | Unlinked provider                                                                                                             | ACH or check to the nonprofit                               | When the nonprofit marks it Received in the Chariot dashboard |

On a gift the provider pays you outside of Chariot, their own remittance carries the DAFpay identifiers. These examples show where the Tracking ID appears in the memo, usually as "Tracking ID \{id} - Gift through DAFpay". Wording varies by provider.

![](/_fern-files/_img/e9f3b201dfacc3b86004abdfad197bdd01291abbeff131709e2b9990965eed13.webp)![](/_fern-files/_img/eed4141cef99923595aa8305b3d5c7e3aae726bbd75c3e5ce414c89b7e5a18f8.webp)

## Displaying DAFpay Gifts

> **For Fundraising Platforms**
>
> This section is for platforms offering DAFpay across many nonprofits' forms. If you are a nonprofit integrating your own donation form, read [Processing Donations](/guides/dafpay/integrate-dafpay/managing-gifts#processing-donations) below instead.

The `trackingId` and `externalGrantId` allow a nonprofit to reconcile the funds to the initiated DAFpay grant when the funds arrive. Display both IDs prominently and searchable in your dashboard.

### What to Show

| Dashboard field   | Grant field               | Why the nonprofit needs it                                                                                                                                    |
| ----------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tracking ID       | `trackingId`              | Match the gift to an incoming payment or remittance.                                                                                                          |
| External Grant ID | `externalGrantId`         | Match the provider's own grant or payment record.                                                                                                             |
| Amount            | `amount`                  | The submitted amount, converted from cents.                                                                                                                   |
| DAF provider      | `fundId`                  | Use the Grant's `fundId` with [Get DAF](/api/donor-advised-funds/get) to display the fund's human-readable name, such as Fidelity Charitable or DAFgiving360. |
| Donor information | The donor fields you have | Identify the gift.                                                                                                                                            |
| Grant status      | `status`                  | The current state Chariot returns.                                                                                                                            |

> **Missing Tracking IDs**
>
> Some DAF providers do not pass the Tracking ID through on their remittances, which is why the External Grant ID matters as a second route. When neither appears, the nonprofit falls back to the fund name, amount, date, and designation.

### Keep the Records Current

Subscribe to `grant.created` and `grant.updated`. When an event arrives, retrieve the current Grant and update the existing transaction using the stored Grant ID. If you support unintegrated providers, subscribe to `unintegrated_grant.created` and `unintegrated_grant.updated` and read those through their own endpoints.

Display the status Chariot returns. Grant creation means the request was submitted to the provider. When the Grant moves to Completed, either automatically when the funds are recorded or when the nonprofit marks it received, update your transaction from the Grant update.

### Recording DAFpay Gifts

The funds in a DAF legally belong to the provider, so most nonprofits hard credit the DAF and soft credit the donor.

A DAFpay gift is initiated, not received. Record it in a pending state rather than as paid, and update it on `grant.updated` once the grant is received.

Expect nonprofits to ask whether DAFpay gifts sync automatically, and to want to review these records before they do.

### Cancellations and Refunds

A donor may be able to cancel a pending grant through their DAF provider before disbursement, subject to that provider's rules. Some providers report the cancellation or refund back to Chariot, and the Grant moves to `Canceled` on its own, so handle that status change the same way you handle any other. Chariot requires this reporting of new DAFpay integrations, so the set of providers that do it keeps growing. Where a provider does not report it, the Grant stays where it is until the donor or the nonprofit tells Chariot and Chariot marks it canceled. Your platform cannot cancel a Grant through the API.

## Processing Donations

> **For Organizations**
>
> Donations represent gifts in Chariot and are only available to Chariot Deposit Account holders. If you are a platform offering DAFpay across many nonprofits' forms, read [Displaying DAFpay Gifts](/guides/dafpay/integrate-dafpay/managing-gifts#displaying-dafpay-gifts) above instead.

Donations can be created from DAFpay gifts created via [Create Grant](/api/grants/create), or other gifts that land in an organization's account from a Chariot disbursement partner or a connected payment source. Building your gift processing around Donations allows you to use the same workflow for DAFpay gifts and gifts from your other connected payment sources.

> **Tip**
>
> Every Grant has a Donation, but not every Donation has a Grant.

### Find the Donation

The donation record is created after the Grant. Once the Donation exists, its ID is added to the corresponding grant. This happens asynchronously, so `donationId` may not be present if you retrieve the Grant immediately.

Once the Donation exists, it behaves like any other gift in Chariot. [Donation Status](/guides/processing/donation-status) covers `payment_status`, settlement timestamps, retrieving donations, and writing your own status back.

### Match Payments Outside Chariot

Donations received in your Chariot Deposit Account are automatically tied to the DAFpay initiation. For donations received outside of Chariot, you can use the DAFpay tracking ID to search for the donation and update the status to `Received outside Chariot`.

| Identifier          | Where to find it                                                | Use                                                                   |
| ------------------- | --------------------------------------------------------------- | --------------------------------------------------------------------- |
| Donation ID         | Donation `id`, or the Grant's `donationId`                      | Update the same gift in your CRM.                                     |
| DAFpay Tracking ID  | Grant `trackingId`, or Donation `initiation.dafpay_tracking_id` | Match the provider's remittance to the initiated gift.                |
| Provider Grant ID   | Grant `externalGrantId`                                         | Match the provider's own grant record when the tracking ID is absent. |
| Your transaction ID | `initiation.dafpay_metadata`                                    | Find the original form submission.                                    |

Some DAF providers do not pass the Tracking ID through on their remittances, which is why the External Grant ID matters as a second route. When neither appears, match on the donor's fund name, amount, date, and designation, and review an uncertain match before marking the Donation received. Some providers batch several gifts into one payment, so one payment can match more than one Donation.

> **Info**
>
> Chariot is a financial technology company, not a bank. Chariot Accounts come with a Demand Deposit Account through our banking services partner, Column N.A., Member FDIC. Deposits in Chariot Accounts are eligible for FDIC insurance up to \$250,000 per depositor, for each insurable capacity in which the account is held.