POST api/{context}/pledge/Create

Create a new pledge in Aegis CRM.
If Aegis CRM is responsible for handling recurring payments, and you pass AutoPayment = true, this will create a new profile at
the payment gateway. Make sure that you set the StartDate and DayToCharge appropriately because they will be used to determine
the first payment. If Aegis CRM does not handle the recurring charges, this end point will simply record the information provided.
Due to PCI Compliance, we cannot store full credit card details, so the Number will automatically be masked.

Request Information

ParameterDescriptionAdditional information
pledgeModel

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": "bc78844f-2cf5-4108-b9e0-3f7aa673b207",
  "PartnerID": "sample string 1",
  "PledgeAmount": 1.0,
  "DatePledged": "2020-08-04T10:34:22.4723255-06:00",
  "AppealCode": "sample string 2",
  "StartDate": "2020-08-04T10:34:22.4723255-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-04T10:34:22.4723255-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-04T10:34:22.4723255-06:00</DatePledged>
  <DayToCharge>1</DayToCharge>
  <Frequency>sample string 4</Frequency>
  <ID>bc78844f-2cf5-4108-b9e0-3f7aa673b207</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-04T10:34:22.4723255-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-04T10:34:22.4723255-06:00</StartDate>
  <UnmaskedPaymentNumber>sample string 12</UnmaskedPaymentNumber>
</PledgeModel>