Gift API V2 - Gift Types

@Brenten Sharp
Planned Gift is not supported both on webview gift batch nor SKY API

@Brenten Sharp
I don't know what you mean by “once off” payment. Do you mean someone made a single donation? or do you mean someone is making a pledge payment?

@Brenten Sharp
RecurringGift is NOT a real gift. it is the “template” that tells RE how much to charge and the schedule, so if you are looking to create a recurring gift for it to charge every month, then this is good, BUT if you are looking to create a recurring gift payment (actual gift/cash/money), then you need to create RecurringGiftPayment.

this is the full list of gift type:

"gift_type": {
"title": "GiftType",
"enum": [
"None",
"Amendment",
"OneTime",
"GiftInKind",
"GeneralLedgerReversal",
"MatchingGiftPledge",
"MatchingGiftPayment",
"MatchingGiftWriteOff",
"Other",
"PlannedGift",
"Pledge",
"PledgePayment",
"PledgeWriteOff",
"RecurringGift",
"RecurringGiftPayment",
"Stock",
"SoldStock",
"Adjustment"
],
"type": "string",
"description": "The gift type."
},

if you are trying to create a single gift that looks to be “OneTime”, if you are trying to create a pledge payment, then it is PledgePayment.

@Erik Leaver @Anthony Gallo I think there is some issue with the SKY API endpoints for creating gift that needs a look into. Other than Pledge, I have not created any gift record programmatically with SKY API, so I don't know for sure. However, given that SKY API “get” endpoint returns “Donation” as the gift type for “single gift”, these gift v2 endpoints documented “OneTime” makes no sense.

https://developer.sky.blackbaud.com/api#api=gft-gifts&operation=CreateGift

https://developer.sky.blackbaud.com/api#api=gft-gifts&operation=AddGiftsToBatch&definition=BatchGiftAddWithTributeLookup

Meanwhile, gift v1, “single gift” is Donation.

https://developer.sky.blackbaud.com/api#api=58bdd5edd7dcde06046081d6&operation=CreateGift

https://developer.sky.blackbaud.com/api#api=58bdd5edd7dcde06046081d6&operation=AddGiftsToBatch

This is going to be a confusion point and potentially coding error on those who uses SKY API. While it would not be good to “change” what has been coded already. I think maybe the SKY API needs to allow both naming “OneTime” and “Donation” both create “single gift” for example.