Skip to main content

For Gift Aid managers

The following sections are for Salesforce users who manage Gift Aid for the given charity. Gift Aid management covers declaration, claims and reversals. Other Gift Aid aspects, such as registering your charity with HMRC are beyond the scope of FinDock.

Simplified overview of the Gift Aid flow

Regardless of whether you are creating records manually or if they are handled through online forms and automated flows, you are always dealing with three primary objects: Contact, Installment and Gift Aid Declaration.

The contact record is where you keep all the main donor information. The declaration record contains the essential information for claiming Gift Aid from the perspective of the HMRC. The installment records are split into two types. The donations are installment records with RecordType ‘Receivable’ and the installment records used to claim Gift Aid have RecordType ‘Gift Aid.’

The basic Gift Aid flow is as follows:

  1. New UK donor gives £60 to your charity and says you can start collecting Gift Aid.
    • New contact record
    • New receivable installment
    • New Gift Aid declaration with start date and empty end date
  2. Donor makes a second donation of £40.
    • New receivable installment
  3. Charity creates and submits a Gift Aid claim.
    • New Gift Aid installment for each donation
  4. HMRC accepts submission.
    • Gift Aid installments status collected
    • Receivable installments marked as Gift Aid collected

Gift Aid flow with new donor

Managing Gift Aid declarations

When it comes to Gift Aid, the primary task is to get Gift Aid declarations from donors and keep them up to date. Donors can make declarations at any given time, and they most likely do not remember exactly what they said last time. For this reason, a single donor (contact) can have multiple declarations in FinDock.

Each declaration is valid on a given date if all the following are true:

  • The declaration is active.
  • The declaration is not in the cooling off period.
  • The start date is empty, earlier than or equal to a given date.
  • The end date is empty or later than a given date.

To get the necessary information to determine validity, you need to ask the donor four key questions:

  1. How was the declaration made (oral or written)?
    If the declaration is oral, it cannot be used immediately. The new declaration goes into a cooling-off period instead.
  2. Is the declaration for a single donation, or can it be used for future donations?
    This tells you whether or not the declaration needs an end date.
  3. Can the declaration be used to claim Gift Aid on past donations?
    If the declaration can be used for past donations, you can leave the start date empty.
  4. Does the donor understand the Gift Aid rules?
    The HMRC requires that you explain the tax implications of a Gift Aid donation and be able to prove you did. (See section 3.6.2 of the Gift Aid Guidance).

Ideally, the declaration and all the necessary information can be automatically captured when a donation is made. For online donations, this can be done through a custom integration with the FinDock Payment API or by using Giving Pages.


The Giving Pages option to create a Gift Aid declaration only supports creating declarations with no start or end date.

Further custom methods for bringing Gift Aid declarations into your org, e.g. from historical data or other systems, can be created using our Gift Aid global APEX classes. You can also use other Salesforce data loading tools for this purpose, such as bulk importing with Salesforce Data Loader.

For Gift Aid declarations added via the FinDock Payment API, note that there is automatic normalization of postal codes.

Manually create Gift Aid declarations

If you need to manually create a Give Aid declaration, you can use the Gift Aid Declaration Lightning component on the contact record of the donor.

To create a new declaration:

  1. Open the contact record for the donor.
  2. On the Gift Aid Declarations component, click New. Gift Aid new declaration
  3. Fill in the declaration details. For further information, see the table here.
  4. Click Save or click Save & New if you need to create another declaration.

Close Gift Aid declarations

You may need to close Gift Aid declarations for any number of reasons. Often it is related to employment status or something that impacts the donor’s ability to pay UK taxes.

You can use the Gift Aid Declaration Lightning component to close declarations for the donor. While you can technically close individual Gift Aid declaration records, typically it is best to close all declarations for the donor at once.

To close Gift Aid declarations:

  1. Open the contact record for the donor.
  2. On the Gift Aid Declarations component, click Close All Valid Gift aid Declarations.
  3. Fill in the fields in the popup window:
    • Close Date
    • Close Reason
    • Comments

When you close declarations, the End Date is changed to the Close Date you entered. The only exception to this logic is in the uncommon situation that the Start Date lies in the future. In that case, the Active field on the declaration is set to false.


In the following illustration, a donor has three Gift Aid declarations. Like most donors, she hasn’t kept track of past declarations, so you have three records for her.

The first declaration she made with her first donation. That one she said you can use for future donations. Later, when she makes another donation, she says you can claim Gift Aid just for that donation. When she makes a third donation, she sets up a recurring donation and says you can claim Gift Aid on all her donations to your charity.

Her workplace hits a rough patch and has to let most of its workforce go, including her. She calls and requests you end your Gift Aid claims as she is not paying taxes while unemployed.

In this scenario, when you close all Gift Aid declarations on that day, there is an impact on the recurring donations. FinDock automatically reverses one claim that was already claimed and two unclaimed donations lose their Gift Aid eligibility, as illustrated below.

Close all Gift Aid declarations example

Gift Aid Distribution

Gift Aid Distribution assists you in registering Gift Aid for donations from partnerships in accordance with HMRC rules.


FinDock ships a page layout for Gift Aid Distribution. User profiles that need to distribute Gift Aid need to be assigned the Account GiftAid Layout for the Account object.

To claim Gift Aid on partnership donations, every individual partner needs to have an active Gift Aid declaration. When the donation is recorded under the account of the partnership, you can distribute the donation across the partners to claim Gift Aid.

To distribute Gift Aid for partnerships:

  1. Go to the Account Detail page of the partnership.
  2. Click the GA Distribution button.
  3. Select an installment from the picklist and distribute the amount among the partners. The partners are contacts connected to the account that have a valid Gift Aid declaration. The sum of the percentages can be less than, but not more than 100%.
    Gift Aid distribution
  4. Check the ‘Store and auto-apply scenario’ option if you want future donations by this partnership to be distributed the same way.
  5. Click Submit when you are done setting distribution percentages.

After submitting, each of the contacts with a distributed amount gets an additional installment that has Gift Aid as the payment method. When you run your next Gift Aid payment schedule, these installments are included in the claim submission to HMRC.

Gift Aid claim process

Once you have donations and Gift Aid declarations in your org, you can start to claim Gift Aid from HMRC. Submitting a Gift Aid claim to HMRC is handled through payment schedules. The payment schedules create all the necessary files for HMRC and generate the corresponding records in Salesforce, as illustrated below:

Gift Aid claim process

  1. Look for eligible installments.
  2. Generate (or select existing) Gift Aid installments.
  3. Create submission file.
  4. Send submission file to HMRC and receive receipt.
  5. Upload submission file and receipt to Chatter.
  6. Update status of Gift Aid installments to collected

Even before a payment schedule is run, FinDock calculates the eligibility of receivable installments in your org.

Gift Aid eligability

When the Gift Aid package is installed, several fields are added to the Installment object. One of these fields, Eligible for Gift Aid, FinDock uses to determine if a given installment is eligible for claiming Gift Aid.

This eligibility field is a formula field represented with a checkbox that is checked (= true) if the installment meets certain criteria, including:

  • The contact has a valid Gift Aid declaration on the Last Collection Date of the installment. If the field is empty, then Due Date is used.
  • The installment does not already have a related Gift Aid claim.
  • The installment is not explicitly excluded from Gift Aid.
  • The installment status is not Reversed, Refunded, Rejected or Cancelled.
  • The installment amount is greater than zero.
  • The open amount of the installment is zero.
  • The payment method is not Gift Aid.

If an installment is eligible, a second installment with RecordType = Gift Aid is created to serve as the claim for that particular donation when running a Gift Aid claim submission.

Installments linked to an account may also be eligible for Gift Aid. Handling these installments is done through Gift Aid Distribution.

Creating a Gift Aid submission to HMRC

You make a Gift Aid submission by running a payment schedule. The payment schedule needs to have specific setting values (see step 1 below) for FinDock to initiate the claim process with HMRC.

To claim Gift Aid:

  1. Create the payment schedule using the following processing details.
    • Source: GiftAid-Source
    • Payment Method: GiftAid
    • Payment Processor: PaymentHub-GiftAid
    • Target: your specific target (bank account) for Gift Aid claims
  2. Press Start Generation. FinDock checks for eligible installments, creates Gift Aid claim installments for them, and adds the claim installments to the payment schedule.
  3. When the schedule status changes to Generated, use the Data Quality component to validate the schedule details and ensure there are no data issues with the selected installments.
  4. Start the schedule processing phase. For further information, see Running payment schedules.
  5. When the payment schedule is set to process, a Gift Aid claim file is created and sent to HMRC for processing.
  6. When HMRC has accepted the file, FinDock marks the claimed installments as collected.

FinDock assumes all claims in the provided claim file are honored since HMRC does not provide a line by line reconciliation process on Gift Aid claims.

Before the Gift Aid submission is sent to HMRC, FinDock performs two additional quality checks on the submission file. Both the number of records processed and the total Gift Aid amount of the processed records are counted and compared against the resulting submission file. If either does not match the count from the processing job, the submission is canceled, and FinDock generates an error message in ProcessingHub (viewable through ProcessingHub Manager).

The details of the file that is created and submitted to HMRC are stored on a PaymentHub file record. On this record you can find:

  • The payment schedule used to create the file
  • The HMRC mark for the Gift Aid claim
  • The related installment records
  • The number of claimed and reversed records
  • The sum of the amount claimed and sum of the amount reversed
  • The actual file that was created

You can use this data to implement your own checks and auditing on the GiftAid claims and reversals.

Gift Aid PaymentHub File

Reversing Gift Aid claims

FinDock automatically reverses or cancels Gift aid claims that lose eligibility, for example, when:

  • the donation is refunded
  • the donation is excluded from Gift Aid after a claim was submitted
  • there is no longer valid Gift Aid declaration for the donation

When a Gift Aid claim is reversed, FinDock automatically changes the status of the Gift Aid claim record to “Pending Reversal” and submits the update to HMRC with the next claim run as an over-claimed amount.

Reversal trigger process

In the following situations, a Gift Aid claim installment is marked as Pending Reversal or Cancelled:

  • Status of the related receivable installment (original donation) changes to a reversed statuses and did not have a reversed status before. Reversed status values are: Reversed, Refunded, Cancelled and Rejected.
  • Excluded from Gift Aid field on the related receivable installment (original donation) changes from false (unchecked) to true (checked).
  • The Valid Gift Aid Declaration lookup field on the related receivable installment (original donation) is empty (indicating the Gift Aid declaration for the claim is no longer valid).
  • Amount Open changes from 0 to a value other than 0. This ensures reversals are consistent with the Eligible for Gift Aid formula, which only marks receivable installments as eligible for Gift Aid only if the open amount is 0.

If the Gift Aid installment status is Collected, then the installment status is changed to Pending Reversal and picked up in the next Gift Aid claim submission for refunding by HMRC. If the Gift Aid installment status is anything other than Collected, the installment status is changed to Cancelled and removed from the payment schedule.

When you run your next Gift Aid payment schedule, the Gift Aid Update Job selects all installments based on:

  • Payment Method = GiftAid
  • Status = Pending, Pending Reversal or Outstanding
  • Additional SOQL if applicable

The Gift Aid Update Job then attaches the selected installments to the payment schedule.

Claimed Gift Aid for donations that regain eligibility

There are situations in which an installment (donation) is reversed or loses eligibility. This changes the related claimed Gift Aid status to Pending Reversal. In some cases, the donation might regain eligibility before the next Gift Aid payment schedule run.

When this happens, the already claimed Gift Aid installment is set to Collected again, and there is no change to cashflow.

Claimed Gift Aid checkbox reversal behavior

If a claimed Gift Aid installment is set to Pending Reversal, the Gift Aid Claimed checkbox on the related receivable installment (the donation) is unchecked after the Gift Aid payment schedule run where the Gift Aid installment is actually reversed.