PUT api/{context}/pledge/Save

Save a pledge with all of the supplied information.
CAUTION: Values missing from the model will result in the same values missing in Aegis CRM, which could be unintended.
Please ensure that any model values returned by a prior look-up are also supplied to the model before calling the Save method.
Due to PCI Compliance, we cannot store full credit card details, so the Number will automatically be masked.

Request Information

ParameterDescriptionAdditional information
pledgeModel
A model representing an entire pledge record.

Define this parameter in the request body.

Requirements

NumberNotes
#1
The Partner, Appeal, and Pledge Program must already exist in Aegis CRM.
#2
Partner Id, Pledge Amount, Payment Type, Start Date, and Pledge Type are all required fields.
#3
Auto-debiting pledges must have a Pledge Program.

Special Field Notes

Field NameNotes
DayToCharge
Represents the day of the month that it will charge.
Frequency
Valid options include: Once, Daily, Weekly, Monthly, Bimonthly, Quarterly, Annually, Semiannually, Semimonthly
ID
Represents the unique identifier for this pledge.  On Create/POST Auto-generated by the Aegis CRM application, any values you provide will be ignored. On Save/PUT, use only those provided in GET results.
PaymentSubType
For CreditCard, valid options are: Visa, MasterCard, Discover, or American Express. For EFT, valid options are: Checking or Savings 
PaymentTokenID
Generated by the Aegis CRM application when a new recurring profile is created.  Any values you pass will be ignored. 
PaymentType
Valid options include: CreditCard, ElectronicFundsTransfer, Check, Cash, or {Some Other Custom Type That is Meaningless to Aegis CRM} 
PledgeType
Valid options include: OneTime, OpenEnded, FixedPeriod, GoalBased
StartDate
Represents the first day the pledge is due.

Request body formats

application/json, text/json

Sample:
{
  "ID": "6578e4a5-900c-45b3-a9ef-8b2a963cda87",
  "PartnerID": "sample string 1",
  "PledgeAmount": 1.0,
  "DatePledged": "2020-08-04T11:38:18.8225452-06:00",
  "AppealCode": "sample string 2",
  "StartDate": "2020-08-04T11:38:18.8225452-06:00",
  "DayToCharge": 1,
  "PledgeType": "sample string 3",
  "Frequency": "sample string 4",
  "Installments": 1,
  "PledgeProgramName": "sample string 5",
  "Active": true,
  "AutoPayment": true,
  "PaymentType": "sample string 8",
  "PaymentSubType": "sample string 9",
  "PaymentBank": "sample string 10",
  "PaymentNumber": "sample string 12",
  "PaymentExtraID": "sample string 13",
  "PaymentExpDate": "2020-08-04T11:38:18.8225452-06:00",
  "PaymentFirstName": "sample string 14",
  "PaymentMiddleName": "sample string 15",
  "PaymentLastName": "sample string 16",
  "PaymentAddress1": "sample string 17",
  "PaymentAddress2": "sample string 18",
  "PaymentCity": "sample string 19",
  "PaymentStateProvince": "sample string 20",
  "PaymentPostalCode": "sample string 21",
  "PaymentCountry": "sample string 22",
  "PaymentTokenID": "sample string 23",
  "PendingProfileUpdate": true
}

application/xml, text/xml

Sample:
<PledgeModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BDS.Web.WebApi.Models">
  <Active>true</Active>
  <AppealCode>sample string 2</AppealCode>
  <AutoPayment>true</AutoPayment>
  <DatePledged>2020-08-04T11:38:18.8225452-06:00</DatePledged>
  <DayToCharge>1</DayToCharge>
  <Frequency>sample string 4</Frequency>
  <ID>6578e4a5-900c-45b3-a9ef-8b2a963cda87</ID>
  <Installments>1</Installments>
  <PartnerID>sample string 1</PartnerID>
  <PaymentAddress1>sample string 17</PaymentAddress1>
  <PaymentAddress2>sample string 18</PaymentAddress2>
  <PaymentBank>sample string 10</PaymentBank>
  <PaymentCity>sample string 19</PaymentCity>
  <PaymentCountry>sample string 22</PaymentCountry>
  <PaymentExpDate>2020-08-04T11:38:18.8225452-06:00</PaymentExpDate>
  <PaymentExtraID>sample string 13</PaymentExtraID>
  <PaymentFirstName>sample string 14</PaymentFirstName>
  <PaymentLastName>sample string 16</PaymentLastName>
  <PaymentMiddleName>sample string 15</PaymentMiddleName>
  <PaymentNumber>sample string 12</PaymentNumber>
  <PaymentPostalCode>sample string 21</PaymentPostalCode>
  <PaymentStateProvince>sample string 20</PaymentStateProvince>
  <PaymentSubType>sample string 9</PaymentSubType>
  <PaymentTokenID>sample string 23</PaymentTokenID>
  <PaymentType>sample string 8</PaymentType>
  <PendingProfileUpdate>true</PendingProfileUpdate>
  <PledgeAmount>1</PledgeAmount>
  <PledgeProgramName>sample string 5</PledgeProgramName>
  <PledgeType>sample string 3</PledgeType>
  <StartDate>2020-08-04T11:38:18.8225452-06:00</StartDate>
  <UnmaskedPaymentNumber>sample string 12</UnmaskedPaymentNumber>
</PledgeModel>