Bloomerang.useKey(publicKey)This function uses the public key to submit the form to the correct organization. Get the public key by clicking Settings >Integrations >API Keys v1.0 and copying the Public API Key.
| Parameter | Required | Description |
|---|---|---|
publicKey | required | A string that begins with pub_ |
Bloomerang.useProcessor(id, type, publicKey, isTestMode, bluePayTPS, restrictBPCredit)Tells Bloomerang which processor to post the credit card or EFT information to. Use this function only if the form uses BluePay and supports EFT. Otherwise, Spreedly handles credit card processing.
| Parameter | Required | Description |
|---|---|---|
id | required | The Bloomerang ID of the processor. Get the ID by clicking Settings, View All Settings in Bloomerang. ClickEdit on the Transactions tile, and then Credit Card Processors. Also see How to Get Bloomerang IDs. |
type | required | Valid value is BluePay |
publicKey | required | The BluePay processor’s public key. Find this in the Account ID field of the processor’s page in Bloomerang. |
isTestMode | optional | A boolean value telling whether the processor is in test mode. Defaults to false. |
bluePayTPS | required | The MD5 hash of the string concatenation of the BluePay private key and the string AUTH0ACH. For example, if the BluePay private key were 1111, bluePayTPS would be the MD5 hash of 1111AUTH0ACH, or c8fc6dfcf7fd6373a2b0d4154a4cb709. |
restrictBPCredit | required | A boolean value. Must be true. Ensures that bad guys can’t use the BluePay TPS to authorize credit cards fraudulently. |
Bloomerang.useDonationId(id)Tells Bloomerang which donation form you are using.
| Parameter | Required | Description |
|---|---|---|
id | required | The ID associated with this form. See How to Get Bloomerang IDs. |
Bloomerang.Account.individual()Sets the account type of the constituent to Individual (a person, not an organization).
Bloomerang.Account.organization()Sets the account type of the constituent to Organization (not an individual).
Bloomerang.Account.organizationName(name)Sets the full name of the organization. Also calls Bloomerang.Account.organization() to set the type of the account to Organization.
| Parameter | Required | Description |
|---|---|---|
name | required | The full name of the organization |
Bloomerang.Account.firstName(name)Sets the constituent’s first name. This does not set the account type to Individual. If the account is already set to Organization, first call Bloomerang.Account.individual().
| Parameter | Required | Description |
|---|---|---|
name | required | The constituent’s first name |
Bloomerang.Account.middleName(name)Sets the constituent’s middle name. This does not set the account type to Individual. If the account is already set to Organization, first call Bloomerang.Account.individual().
| Parameter | Required | Description |
|---|---|---|
name | required | The constituent’s middle name |
Bloomerang.Account.lastName(name)Sets the constituent’s last name. This does not set the account type to Individual. If the account is already set to Organization, first call Bloomerang.Account.individual().
| Parameter | Required | Description |
|---|---|---|
name | required | The constituent’s last name |
Bloomerang.Account.prefix(value)Sets the constituent’s name prefix. This does not set the account type to Individual. If the account is already set to Organization, first call Bloomerang.Account.individual().
| Parameter | Required | Description |
|---|---|---|
value | required | The constituent’s name prefix. Valid values are: Mr, Miss, Ms, Mrs, Master, Rev, Pastor, Fr, Dr, Atty, Prof, Hon, Pres, Coach , Gov, Sir, Rep, Sen, Pvt, Sgt, Maj, Capt, Cmdr, Lt, Col, Gen, Rabbi, Sr |
Bloomerang.Account.suffix(value)Sets the constituent’s name suffix. This does not set the account type to Individual. If the account is already set to Organization, first call Bloomerang.Account.individual().
| Parameter | Required | Description |
|---|---|---|
value | required | The constituent’s name suffix. Valid values are: Jr, Sr, II, III, IV, V, Esq, PhD, MD, DDS |
Bloomerang.Account.informalName(name)Sets the constituent’s informal name. This does not set the account type to Individual. If the account is already set to Organization, first call Bloomerang.Account.individual().
If this is not called, the informal name defaults to the constituent’s first name.
| Parameter | Required | Description |
|---|---|---|
name | required | The constituent’s informal name |
Bloomerang.Account.formalName(name)Sets the constituent’s formal name. This does not set the account type to Individual. If the account is already set to Organization, first call Bloomerang.Account.individual().
If this is not called, the informal name defaults to prefix lastName. If no prefix is specified, it defaults to firstName lastName.
| Parameter | Required | Description |
|---|---|---|
name | required | The constituent’s formal name |
Bloomerang.Account.envelopeName(name)Sets the constituent’s envelope name. This is the name that should be printed on mailing labels. This does not set the account type to Individual. If the account is already set to Organization, first call Bloomerang.Account.individual().
If this is not called, the envelope name defaults to prefix firstName lastName suffix.
| Parameter | Required | Description |
|---|---|---|
name | required | The constituent’s envelope name |
Bloomerang.Account.recognitionName(name)Sets the constituent’s recognition name. This does not set the account type to Individual. If the account is already set to Organization, first call Bloomerang.Account.individual().
If this is not called, the recognition name defaults to prefix firstName middleName lastName suffix.
| Parameter | Required | Description |
|---|---|---|
name | required | The constituent’s recognition name |
Bloomerang.Account.jobTitle(title)Sets the constituent’s job title.
| Parameter | Required | Description |
|---|---|---|
title | required | The constituent’s job title |
Bloomerang.Account.employer(name)Sets the name of the constituent’s employer.
| Parameter | Required | Description |
|---|---|---|
name | required | The constituent’s employer |
Bloomerang.Account.website(url)Sets the constituent’s website.
| Parameter | Required | Description |
|---|---|---|
url | required | The URL of the constituent’s website |
Bloomerang.Account.facebook(id)Sets the constituent’s Facebook account.
| Parameter | Required | Description |
|---|---|---|
id | required | The constituent’s Facebook page URL |
Bloomerang.Account.twitter(id)Sets the constituent’s Twitter account.
| Parameter | Required | Description |
|---|---|---|
id | required | The constituent’s Twitter handle |
Bloomerang.Account.linkedInId(id)Sets the constituent’s LinkedIn account.
| Parameter | Required | Description |
|---|---|---|
id | required | The constituent’s LinkedIn URL |
Bloomerang.Account.gender(value)Sets the constituent’s gender.
| Parameter | Required | Description |
|---|---|---|
value | required | The constituent’s gender. Valid values are Male, Female, or Other |
Bloomerang.Account.birthdate(date)Sets the constituent’s date of birth.
| Parameter | Required | Description |
|---|---|---|
date | required | The constituent’s date of birth. String in yyyy-mm-dd format. |
Bloomerang.Account.homePhone(number, ext)Sets the constituent’s primary phone number, with a type of Home. Shortcut for Bloomerang.Account.setPhone(Home). You can only set one phone number on a constituent via forms.
When the phone number is submitted, it is added as a new phone number and marked as primary. If the constituent already has that phone number, it is marked as primary.
| Parameter | Required | Description |
|---|---|---|
number | required | The constituent’s phone number. String. Add + in front of an international number. For example, +82112223333 |
ext | optional | The phone number’s extension |
Bloomerang.Account.workPhone(number, ext)Sets the constituent’s primary phone number, with a type of Work. Shortcut for Bloomerang.Account.setPhone(Work). You can only set one phone number on a constituent via forms.
When the phone number is submitted, it is added as a new phone number and marked as primary. If the constituent already has that phone number, it is marked as primary.
| Parameter | Required | Description |
|---|---|---|
number | required | The constituent’s phone number. String. Add + in front of an international number. For example, +82112223333 |
ext | optional | The phone number’s extension. |
Bloomerang.Account.setPhone(type, number, ext)Sets the constituent’s primary phone number and specifies the type. You can only set one phone number on a constituent via forms.
When the phone number is submitted, it is added as a new phone number and marked as primary. If the constituent already has that phone number, it is marked as primary.
| Parameter | Required | Description |
|---|---|---|
type | required | The type of phone number. Valid values are Home, Work, Mobile, or Fax |
number | required | The constituent’s phone number. String. Add + in front of an international number. For example, +82112223333. |
ext | optional | The phone number’s extension |
Bloomerang.Account.homeEmail(address)Sets the constituent’s primary email address, with a type of Home. Shortcut for Bloomerang.Account.setEmail(Home, address). You can only set one email address on a constituent via forms.
When the email address is submitted, it is added as a new email address and marked as primary. If the constituent already has that email address, it is marked as primary.
| Parameter | Required | Description |
|---|---|---|
address | required | The constituent’s home email address |
Bloomerang.Account.workEmail(address)Sets the constituent’s primary email address, with a type of Work. Shortcut for Bloomerang.Account.setEmail(Work, address). You can only set one email address on a constituent via forms.
When the email address is submitted, it is added as a new email address and marked as primary. If the constituent already has that email address, it is marked as primary.
| Parameter | Required | Description |
|---|---|---|
address | required | The constituent’s work email address |
Bloomerang.Account.setEmail(type, address)Sets the constituent’s primary email address and specifies the type. You can only set one email address on a constituent via forms.
When the email address is submitted, it is added as a new email address and marked as primary. If the constituent already has that email address, it is marked as primary.
| Parameter | Required | Description |
|---|---|---|
type | required | The type of email address. Valid values are Home or Work. |
address | required | The constituent’s email address |
Bloomerang.Account.homeAddress(street, city, state, zip, country)Sets the constituent’s primary address, with a type of Home. Shortcut for Bloomerang.Account.setAddress(Home). You can only set one address on a constituent via forms.
If the constituent already has an address, Bloomerang normalizes the submitted address (e.g., 123 North 4th Street becomes 123 N 4TH ST), then compares it with existing addresses. If a match is found, the existing address is updated and marked as primary. If not, a new address is added and marked as primary.
If the country is not United States, Canada, or Bermuda, put the entire address in the street argument. Don’t use city, state, or zip.
| Parameter | Required | Description |
|---|---|---|
street | required | The street part of the constituent’s address (e.g., 123 4th Street) |
city | optional | The city (e.g., Indianapolis) |
state | optional | The state (e.g., Indiana). Use state abbreviations (IN). |
zip | optional | The ZIP code (e.g., 46216) |
country | optional | The country code. We recommend the 2- or 3-digit ISO country code. Default is US. |
Bloomerang.Account.workAddress(street, city, state, zip, country)Sets the constituent’s primary address, with a type of Work. Shortcut for Bloomerang.Account.setAddress(Work). You can only set one address on a constituent via forms.
Bloomerang normalizes and compares the submitted address against existing addresses. If a match is found, the existing address is updated and marked as primary. If not, a new address is added and marked as primary.
For non-US/Canada/Bermuda addresses, put the entire address in the street argument.
| Parameter | Required | Description |
|---|---|---|
street | required | The street part of the address |
city | optional | The city |
state | optional | The state. Use abbreviations. |
zip | optional | The ZIP code |
country | optional | 2- or 3-digit ISO country code. Default is US. |
Bloomerang.Account.setAddress(type, street, city, state, zip, country)Sets the constituent’s primary address and specifies the type. You can only set one address on a constituent via forms.
Bloomerang normalizes the submitted address and compares it against existing addresses. Matches are updated and marked as primary; new addresses are added and marked as primary.
For non-US/Canada/Bermuda addresses, put the entire address in the street argument.
| Parameter | Required | Description |
|---|---|---|
type | required | The type of address. Valid values are Home, Work, Vacation. |
street | required | The street part of the address |
city | optional | The city |
state | optional | The state. Use abbreviations. |
zip | optional | The ZIP code |
country | optional | 2- or 3-digit ISO country code. Default is US. |
Bloomerang.Account.customFreeformField(fieldID, value)Sets a freeform custom field on the constituent account.
| Parameter | Required | Description |
|---|---|---|
fieldID | required | The ID of the custom field |
value | required | The value (string, number, or date) that should be set for the field |
Bloomerang.Account.customPickField(fieldID, valueID1, valueID2, ...)Sets a pick-one or pick-multiple custom field on the constituent account.
For a pick-one field, only pass in one value’s ID. This value replaces an existing value for that field.
For a pick-multiple field, you can pass in as many value IDs as there are defined values. Each value is a separate argument. Submitted values replace any existing values for that field.
| Parameter | Required | Description |
|---|---|---|
fieldID | required | The ID of the field |
valueID | required | The IDs of the values that should be set for the field |
Bloomerang.Account.clearCustomFields()Clears all the custom field values on the account. Call this function to remove any selections left over from a previous submission attempt. Then update the custom fields with values from the form.
This does not delete any custom field values in the Bloomerang database.
Bloomerang.Donation.date(date)Deprecated. Bloomerang automatically uses the date the donation was submitted.
Bloomerang.Donation.note(text)Sets the Note field on the donation.
| Parameter | Required | Description |
|---|---|---|
text | required | The note to be added to the transaction. String, up to 64KB in length. |
Bloomerang.Donation.amount(amount)Sets the donation amount.
| Parameter | Required | Description |
|---|---|---|
amount | required | The amount of the donation. String (with U.S. formatting, $5.00) or number (5). |
Bloomerang.Donation.nonDeductible(amount)Sets the nondeductible part of the donation amount. (The tax-deductible part is amount minus nonDeductible.)
| Parameter | Required | Description |
|---|---|---|
amount | required | The nondeductible amount. Number. |
Bloomerang.Donation.fundID(id)Sets the fund for the donation.
If the submitted fund does not exist in Bloomerang, the transaction defaults to the form’s first fund.
| Parameter | Required | Description |
|---|---|---|
id | required | The fund’s Bloomerang ID |
Bloomerang.Donation.campaign(name)Sets the campaign for the donation. This overrides any campaign set in the Bloomerang form builder.
This function does not create campaigns in Bloomerang. First create the campaign in Bloomerang, then use the exact name on your form.
| Parameter | Required | Description |
|---|---|---|
name | required | The name of the campaign as set in Bloomerang. If the name changes, update the form to use the new name. Defaults to the campaign set in Bloomerang’s form builder. |
Bloomerang.Donation.appeal(name)Sets the appeal for the donation. This overrides any appeal set in the Bloomerang form builder.
This function does not create appeals in Bloomerang. First create the appeal in Bloomerang, then use the exact name on your form.
| Parameter | Required | Description |
|---|---|---|
name | required | The name of the appeal as set in Bloomerang. If the name changes, update the form to use the new name. Defaults to the appeal set in Bloomerang’s form builder. |
Bloomerang.Donation.tribute(name)Sets the tribute for the donation.
This function does not create tributes in Bloomerang. First create the tribute in Bloomerang, then use the exact name on your form.
| Parameter | Required | Description |
|---|---|---|
name | required | The name of the existing tribute as set in Bloomerang. If the name changes, update the form to use the new name. |
Bloomerang.Donation.tributeType(name)Sets the donation’s tribute type.
| Parameter | Required | Description |
|---|---|---|
name | required | The name of the tribute type. Valid values are In Honor of, In Memory of. |
Bloomerang.Donation.customFreeformField(fieldID, value)Sets a custom field on the donation. The constituent can type anything into this field.
| Parameter | Required | Description |
|---|---|---|
fieldID | required | The field’s Bloomerang ID |
value | required | Valid formats are string, number, date |
Bloomerang.Donation.customPickField(fieldID, valueID1, valueID2, ...)Sets a custom field on the donation. The constituent can pick one or more values, depending on how the field was created in Bloomerang.
This function replaces the field’s values on the JavaScript object.
| Parameter | Required | Description |
|---|---|---|
fieldID | required | The field’s Bloomerang ID |
valueID(s) | required | The values’ Bloomerang IDs. For pick-one fields, pass in one valueID. For pick-multiple fields, pass in multiple valueIDs, each as a separate argument. |
Bloomerang.Donation.clearCustomFields()Clears all the custom field values for the donation. Call this function to remove any selections left over from a previous submission attempt. Then update the custom fields with values from the form.
This does not delete any custom field values in the Bloomerang database.
Bloomerang.RecurringDonation.date(date)Deprecated. Bloomerang automatically uses the date the recurring donation was submitted.
The start date of a recurring donation is set using Bloomerang.RecurringDonation.startDate.
Bloomerang.RecurringDonation.note(text)Sets the Note field on the recurring donation.
| Parameter | Required | Description |
|---|---|---|
text | required | The note to be added to the transaction. String, up to 64KB in length. |
Bloomerang.RecurringDonation.amount(amount)Sets the amount of the recurring donation. The amount is charged at each interval specified by Bloomerang.RecurringDonation.frequency(value).
| Parameter | Required | Description |
|---|---|---|
amount | required | The amount of the recurring donation |
Bloomerang.RecurringDonation.nonDeductible(amount)Sets the nondeductible part of the recurring donation amount. (The tax-deductible part is amount minus nonDeductible.)
| Parameter | Required | Description |
|---|---|---|
amount | required | The nondeductible amount. Number. Does not accept strings. |
Bloomerang.RecurringDonation.fundID(id)Sets the fund for the recurring donation.
If the submitted fund does not exist in Bloomerang, the transaction defaults to the form’s first fund.
| Parameter | Required | Description |
|---|---|---|
id | required | The fund’s Bloomerang ID |
Bloomerang.RecurringDonation.campaign(name)Sets the campaign for the recurring donation. This overrides any campaign set in the Bloomerang form builder.
This function does not create campaigns in Bloomerang. First create the campaign in Bloomerang, then use the exact name on your form.
| Parameter | Required | Description |
|---|---|---|
name | required | The campaign name as set in Bloomerang. Defaults to the campaign set in the form builder. |
Bloomerang.RecurringDonation.appeal(name)Sets the appeal for the recurring donation. This overrides any appeal set in the Bloomerang form builder.
This function does not create appeals in Bloomerang. First create the appeal in Bloomerang, then use the exact name on your form.
| Parameter | Required | Description |
|---|---|---|
name | required | The appeal name as set in Bloomerang. Defaults to the appeal set in the form builder. |
Bloomerang.RecurringDonation.tribute(name)Sets the tribute for the current recurring donation.
This function does not create tributes in Bloomerang. First create the tribute in Bloomerang, then use the exact name on your form.
| Parameter | Required | Description |
|---|---|---|
name | required | The name of the existing tribute as set in Bloomerang. |
Bloomerang.RecurringDonation.tributeType(name)Sets the recurring donation’s tribute type.
| Parameter | Required | Description |
|---|---|---|
name | required | The name of the tribute type. Valid values are In Honor of, In Memory of. |
Bloomerang.RecurringDonation.frequency(value)Sets how often the recurring donation should occur.
| Parameter | Required | Description |
|---|---|---|
value | required | The frequency of the recurring donation. Valid values are Weekly, Monthly, Quarterly, Yearly. Invalid values default to Monthly. |
Bloomerang.RecurringDonation.weekly()Sets the recurring donation to happen weekly. Shortcut for Bloomerang.RecurringDonation.frequency(Weekly).
Bloomerang.RecurringDonation.monthly()Sets the recurring donation to happen monthly. Shortcut for Bloomerang.RecurringDonation.frequency(Monthly).
Bloomerang.RecurringDonation.quarterly()Sets the recurring donation to happen quarterly. Shortcut for Bloomerang.RecurringDonation.frequency(Quarterly).
Bloomerang.RecurringDonation.yearly()Sets the recurring donation to happen yearly. Shortcut for Bloomerang.RecurringDonation.frequency(Yearly).
Bloomerang.RecurringDonation.startDate(date)Sets the date when the recurring donation should start processing payments. This is not the same as Bloomerang.RecurringDonation.date, which is when the form was submitted.
If the start date is the same as the current date, the first payment processes immediately. Otherwise, it occurs in the early morning of the start date (UTC time).
Time zones can set the start date earlier than the donation’s date. If this happens, Bloomerang changes the start date to match the donation’s date. The payment processes immediately.
| Parameter | Required | Description |
|---|---|---|
date | required | The date on which the recurring donation should start processing donations. String in yyyy-mm-dd format. |
Bloomerang.RecurringDonation.customFreeformField(fieldID, value)Sets a custom field on the recurring donation. The constituent can type anything into this field.
| Parameter | Required | Description |
|---|---|---|
fieldID | required | The field’s Bloomerang ID |
value | required | Valid formats are string, number, date |
Bloomerang.RecurringDonation.customPickField(fieldID, valueID1, valueID2, ...)Sets a custom field on the donation. The constituent can pick one or more values, depending on how the field was created in Bloomerang.
This function replaces the field’s values on the JavaScript object.
| Parameter | Required | Description |
|---|---|---|
fieldID | required | The field’s Bloomerang ID. |
valueID(s) | required | The values’ Bloomerang IDs. For pick-one fields, pass in one valueID. For pick-multiple fields, pass in multiple valueIDs, each as a separate argument. |
Bloomerang.RecurringDonation.clearCustomFields()Clears all the custom fields for the donation. Call this function to remove any selections left over from a previous submission attempt. Then update the custom fields with values from the form.
This does not delete any custom field values in the Bloomerang database.
Bloomerang.CreditCard.spreedlyToken(token)Sets the Spreedly token for processing a credit card. Spreedly is a service that reduces PCI compliance scope by securely handling credit card processing. Bloomerang recommends using the Spreedly Express Payment Widget to obtain a Spreedly token.
| Parameter | Required | Description |
|---|---|---|
token | required | The Spreedly token that should be charged. |
Bloomerang.CreditCard.expirationMonth(month)The month the credit card expires.
| Parameter | Required | Description |
|---|---|---|
month | required | The expiration month. |
Bloomerang.CreditCard.expirationYear(year)The year the credit card expires.
| Parameter | Required | Description |
|---|---|---|
year | required | The expiration year. |
Bloomerang.InKind.marketValue(value)The gift’s fair market value.
| Parameter | Required | Description |
|---|---|---|
value | required | The gift’s fair market value. String in U.S. formatting, or number. |
Bloomerang.InKind.description(text)Sets the description of the in-kind gift.
| Parameter | Required | Description |
|---|---|---|
text | required | The description of the gift. Up to 255 characters. |
Bloomerang.InKind.type(type)Sets the type of gift (goods or services).
| Parameter | Required | Description |
|---|---|---|
type | required | The type of gift. Valid values are Goods, Services. |
Bloomerang.InKind.goods()Sets the gift type to Goods. Shortcut for Bloomerang.InKind.type(Goods).
Bloomerang.InKind.services()Sets the gift type to Services. Shortcut for Bloomerang.InKind.type(Services).
Bloomerang.Check.number(number)Sets the check number.
| Parameter | Required | Description |
|---|---|---|
number | required | The check number |
Bloomerang.Check.date(date)Sets the date of the check.
| Parameter | Required | Description |
|---|---|---|
date | required | The date the check was written. String in yyyy-mm-dd format. |
Bloomerang.Eft.type(type)Sets the type of EFT account (checking or savings).
| Parameter | Required | Description |
|---|---|---|
type | required | The EFT account type. Valid values are Checking, Savings. |
Bloomerang.Eft.checking()Sets the EFT account type to Checking. Shortcut for Bloomerang.Eft.type(Checking).
Bloomerang.Eft.savings()Sets the EFT account type to Savings. Shortcut for Bloomerang.Eft.type(Savings).
Bloomerang.Eft.accountNumber(number)Sets the account number that will be charged with the EFT.
| Parameter | Required | Description |
|---|---|---|
number | required | The account number that will be charged |
Bloomerang.Eft.routingNumber(number)Sets the bank’s nine-digit routing number.
| Parameter | Required | Description |
|---|---|---|
number | required | The routing number for the EFT account |
Bloomerang.Interaction.date(date)Sets the Date on the timeline that the new interaction should have.
| Parameter | Required | Description |
|---|---|---|
date | required | The date of the interaction |
Bloomerang.Interaction.subject(subject)Sets the Subject for the new interaction.
| Parameter | Required | Description |
|---|---|---|
subject | required | The subject of the interaction. String, up to 255 characters. |
Bloomerang.Interaction.note(note)Sets the Note for the new interaction.
| Parameter | Required | Description |
|---|---|---|
note | optional | The note for the new interaction. String, up to 64KB. |
Bloomerang.Interaction.channel(channel)Sets the Channel for the new interaction.
| Parameter | Required | Description |
|---|---|---|
channel | required | The channel of the new interaction. String. Valid values: Email, Phone, TextMessage, Mail, InPerson, SocialMedia, Website, Other. |
Bloomerang.Interaction.purpose(purpose)Sets the purpose for the new interaction.
| Parameter | Required | Description |
|---|---|---|
purpose | required | The purpose of the new interaction. String. Valid values: Acknowledgement, ImpactCultivation, Newsletter, Receipt, Solicitation, SpecialEvent, VolunteerActivity, PledgeReminder, Welcome, Other. |
Bloomerang.Interaction.inbound(inbound)Sets the interaction as inbound. An inbound interaction is one initiated by the constituent.
| Parameter | Required | Description |
|---|---|---|
inbound | required | Sets the interaction as inbound or not. Boolean. |
Bloomerang.Interaction.customFreeformField(fieldID, value)Sets a custom field on the interaction. The constituent can type anything into this field.
| Parameter | Required | Description |
|---|---|---|
fieldID | required | The field’s Bloomerang ID. |
value | required | Valid formats are string, number, date |
Bloomerang.Interaction.customPickField(fieldID, valueID1, valueID2, ...)Sets a custom field on the interaction. The constituent can pick one or more values, depending on how the field was created in Bloomerang. This function replaces the field’s values on the JavaScript object.
| Parameter | Required | Description |
|---|---|---|
fieldID | required | The field’s Bloomerang ID. |
valueID(s) | required | The values’ Bloomerang IDs. For pick-one fields, pass in one valueID. For pick-multiple fields, pass in multiple valueIDs, each as a separate argument. |
Bloomerang.Interaction.clearCustomFields()Clears all the custom field values for the interaction. Call this function to remove any selections left over from a previous submission attempt. Then update the custom fields with values from the form.
This does not delete any custom field values in the Bloomerang database.
Bloomerang.Api.donate()Posts a one-time donation to Bloomerang. Set up all the data you want to post using the data functions before calling this function. Or set up the data as part of your Bloomerang.Api.OnSubmit handler.
Bloomerang.Api.recurringDonate()Posts a recurring donation to Bloomerang. Set up all the data you want to post using the data functions before calling this function. Or set up the data as part of your Bloomerang.Api.OnSubmit handler.
Bloomerang.captchaResponse(response)Google reCAPTCHA sends a Base64-encoded response to the form after client-side validation. Use this function to pass the CAPTCHA response from Google to Bloomerang.
For this function to work, CAPTCHA must be turned on in Bloomerang for the type of form you are using (transaction or interaction).
| Parameter | Required | Description |
|---|---|---|
response | required | The CAPTCHA response from Google. |
Bloomerang.continueFinancialSubmission(form)This helper function checks that you are not submitting financial information more than once. Call this immediately before submitting the form. If it returns true, the form has not been submitted. If it returns false, do not continue the submission — another submission for the same form is already in progress.
| Parameter | Required | Description |
|---|---|---|
form | required | The form’s JavaScript DOM element |
Bloomerang.cancelFinancialSubmission(form)A helper function to clear the restriction set by Bloomerang.continueFinancialSubmission(). Call this when you are finished processing the form — for example, after an error response or when you want the constituent to be able to submit the form again.
| Parameter | Required | Description |
|---|---|---|
form | required | The form’s JavaScript DOM element |
Bloomerang.Api.submitInteraction()Posts a new Interaction to Bloomerang. Set up all the data you want to post using the data functions before calling this function. Or set up the data as part of your Bloomerang.Api.OnSubmit handler.