Skip to main content
WeGive recurring plans sync to NPC GiftCommitment records with RecurrenceType = OpenEnded, plus a GiftCommitmentSchedule child row that defines amount and cadence. Pledges also use GiftCommitment but with a formal commitment type; see Pledge.

​
GiftCommitment fields

​
GiftCommitmentSchedule fields

If a commitment has no schedule, WeGive falls back to the commitment-level NextTransactionAmount, EffectiveTransactionPeriod, and EffectiveTransactionInterval. A new plan with no resolvable amount is skipped.

​
Status mapping

NPC commitment statuses map to WeGive plan states. Override under Status mapping in Configuration Options.
Push and pull use slightly different maps. On push, WeGive’s cancelled and ended plan states both write NPC Closed, and failing/in-arrears both write Failing. On pull, the reverse isn’t quite symmetric: NPC Closed always becomes WeGive cancelled (there’s no way back to ended specifically), Lapsed also maps to failing (not just Failing itself), and Draft maps to active rather than being skipped.

​
Frequency mapping

1st-and-15th-of-the-month billing is not supported for NPC and is blocked at checkout for NPC-connected organizations. NPC’s TransactionPeriod picklist (Custom/Daily/Weekly/Monthly/Yearly) has no semi-monthly value, and mapping it to Monthly would be indistinguishable from a genuinely-monthly commitment on pull — silently flipping those donors to monthly billing.

​
Linkage (create-only)

​
Designations

Recurring plan designations use GiftDefaultDesignation, which is percentage-based. With Fund allocations off, the largest default designation maps to the plan’s single fund, and WeGive pushes one 100 percent designation.

​
Generated gifts

Transactions generated by a recurring plan carry GiftCommitmentId on the GiftTransaction. WeGive uses this to link each installment to its parent plan.

​
Pull filters

When Sync all recurring donations is off, only Active commitments are pulled. The Commitment statuses filter further limits the pull.