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 |
caf-gaye:001025903 |
| 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 (e.g., caf-gaye:001025903).
Direct donations#
Donations for Direct are keyed by the CAF Transaction ID (e.g., caf-gaye:66125564).