Gift API V2 - Gift Types

Brenten Sharp

Hi,

I had gift types working correctly in Gift V2 “Add Gifts to Batch”. When testing today I am getting back an error saying that “PlannedGift” is not in the GiftType. I also tried “Donation” but this returned back the same error.

Should it be:
gift_type: “PlannedGift”

The recurring is working correctly which has “RecurringGift” as the gift type.
What would the once-off payment type be then?

Any help on this would be great.

Thanks,
Brenten

Alex Wong

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

Brenten Sharp

@Alex Wong
Thanks for your reply.
What would I use then for a once-off payment?

Alex Wong

@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

@Alex Wong
I need it setup for either a single gift payment or recurring gift payment. The RecurringGift gift type works I am just not sure what to do for a single gift when sending in Gift Type.

Alex Wong

@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.

Brenten Sharp

@Alex Wong
Thanks Alex, that has worked great. Thanks for your help.