CAF Platform Key Syntax
Identifiers use the prefix caf-gaye:
The CAF integration processes donations from two sources: Payroll (Give As You Earn) and Direct (CAF Account donations). MoveData uses the platform code caf-gaye. Key formats differ by source.
Payroll Giving#
| NPSP Object | NPC Object | Identifier | Example | Platform Key Value |
|---|---|---|---|---|
| Contact | Person Account | PGA Donor Ref No | 1029321 |
caf-gaye:1029321 |
| Account (Employer) | Account (Employer) | Employer Name (slug) | initech |
caf-gaye:initech |
| Campaign (top-level) | Campaign (top-level) | — | — | caf-gaye:caf-gaye |
| Campaign (Employer records) | Campaign (Employer records) | Employer Name (slug) | cyberdynesystems |
caf-gaye:cyberdynesystems |
| Recurring Donation | Gift Commitment | PGA Donor Ref No | 1029321 |
caf-gaye:1029321 |
| Opportunity | Gift Transaction | Date:DonorRef:Sequence | 2026-03-02:2256600:1 |
caf-gaye:2026-03-02:2256600:1 |
| Opportunity (Matched Gift) | Gift Transaction (Matched Gift) | Date:DonorRef:Sequence:match | 2026-03-27:1159064:1:match |
caf-gaye:2026-03-27:1159064:1:match |
Payroll contacts#
Contacts for Payroll donations are identified by the PGA Donor Reference Number (e.g., caf-gaye:1029321).
Payroll accounts (employers)#
Accounts are keyed by a slugified version of the employer name (e.g., caf-gaye:cyberdynesystems).
Payroll campaign hierarchy#
All Payroll donations are grouped under a generic CAF campaign (caf-gaye:caf-gaye). Each employer becomes a fundraiser campaign underneath, keyed by the same slugified employer name as the Account.
Payroll recurring donations#
Recurring donations for Payroll use the same key as the donor's PGA Donor Reference Number (e.g., caf-gaye:1029321).
Payroll donations#
Donations for Payroll are keyed by a composite of Date:DonorRef:Sequence (e.g., caf-gaye:2026-03-02:2256600:1).
Payroll matched gifts#
When an employer matches donations, MoveData creates a separate matched gift Donation. The key appends :match to the original donation key (e.g., caf-gaye:2026-03-27:1159064:1:match).
Direct Giving#
| NPSP Object | NPC Object | Identifier | Example | Platform Key Value |
|---|---|---|---|---|
| Contact | Person Account | Postcode:FirstName:LastName | SW1A1AA:jane:smith |
caf-gaye:SW1A1AA:jane:smith |
| Campaign (top-level) | Campaign (top-level) | — | — | caf-gaye:caf-gaye |
| Recurring Donation | Gift Commitment | Donation Type Reference | 001025903, 1235303 |
caf-gaye:001025903, caf-gaye:1235303 |
| Opportunity | Gift Transaction | CAF Transaction ID | 66125564 |
caf-gaye:66125564 |
Direct contacts#
Contacts for Direct donations are identified by a composite of Postcode:FirstName:LastName (e.g., caf-gaye:SW1A1AA:jane:smith).
Direct campaign hierarchy#
All Direct donations are grouped under the same generic CAF campaign (caf-gaye:caf-gaye). MoveData does not create an employer campaign tier for Direct donations.
Direct recurring donations#
Recurring donations for Direct use the Donation Type Reference, but only for the donation types that are genuinely recurring. A Direct donation creates or links to a Recurring Donation when its DonationType is one of:
| Donation Type | Example reference | Platform Key Value |
|---|---|---|
CAF Account Regular Donation |
001025903 |
caf-gaye:001025903 |
Standing Order Donation |
8338-05-7778-04 |
caf-gaye:8338-05-7778-04 |
Direct Debit Donation |
1235303 |
caf-gaye:1235303 |
Any other donation type — for example CAF Account Donation or CAF Account Voucher — is a standalone one-off donation with no recurring parent, even if the row still carries a Donation Type Reference. A row with no Donation Type Reference at all does not produce a recurring link either.
MoveData uses the reference exactly as the file carries it, including leading zeros and punctuation. It does not pad, strip or reformat the value, so the reference format varies by donation type: CAF Account Regular Donation references are zero-padded, direct debit references are plain unpadded numbers, and standing order references are sort-code shaped. The Platform Key on your Recurring Donation record must match the reference character for character as it appears in the file — caf-gaye:000957586 and caf-gaye:957586 are different records and will not match each other.
Direct donations#
Donations for Direct are keyed by the CAF Transaction ID (e.g., caf-gaye:66125564).