Gift Transaction Field Mapping

Core fields

WeGive field	NPC field	Sync	Notes
amount	OriginalAmount	↔	Stored in dollars on NPC, cents in WeGive
created_at	TransactionDate	↔
description	Description	↔
status	Status	↔	See status mapping below
source_type	PaymentMethod	↔	See payment method mapping below
correlation_id	GatewayReference	→	Push-only; useful for matching to gateway transactions

Status mapping

The defaults are listed below. Override these in Configuration Options → Status mapping overrides if your org uses customized picklist values.

NPC Status	WeGive status
Paid	success
Pending	pending
Failed	failed
Written-Off	cancelled

Payment method mapping

NPC PaymentMethod	WeGive source_type
Credit Card	card
ACH	bank
Cash	cash
Check	check
PayPal	paypal
Venmo	venmo
Cryptocurrency	crypto
In-Kind	in_kind
Stock	stock
Unknown	(left blank)

Linkage (create-only)

These set the relationship at create time and are not updated on subsequent edits.

WeGive field	NPC field	Notes
owner.npc_id	DonorId	The Account ID for the donor (Person Account or Organization)
campaign.npc_id	CampaignId
scheduled_donation.npc_id	GiftCommitmentId	Set when the transaction was generated by a recurring plan

Designation splits

Splits across funds are stored as GiftTransactionDesignationRelation rows. Each row maps to a WeGive FundAllocation.

WeGive FundAllocation field	NPC GiftTransactionDesignationRelation field
amount	Amount
fund.npc_id	DesignationId