Email opt-in via Donations API

Options
chris 7
chris 7
Ancient Membership First Comment Facilitator Level 1
in Blackbaud Luminate Online® & Blackbaud TeamRaiser® Discussions

Hey all, we're trying out the Donations API for the first time and we have a test form set up. Included is an email opt-in checkbox:



<input type="checkbox" class="checkbox" id="donor_email_opt_in" name="donor.email_opt_in" checked="true" />



Test transactions with live credit cards never seem to opt the person in. Any idea why? The field is present in the ghost form.

Also: is there a way to assign interests using the Donations API? Ideally when they opt-in to receiving email we'd like two interest topics to be flagged on their account. I believe we achieve this with normal (non-API) donation forms by having the two inerest fields checked by default and hidden. That way if they opt-in to receiving email, they will start receiving emails concerning those two interests.

Aaaand lastly, most of our testing has been with <input type="hidden" name="df_preview" value="true" /> and cc 4111111111111111. Unfortunately, when using this method the success page shows fake John Doe transaction info and not the parameter values we passed to it. This makes us unable to see which values Convio correctly understood. Is there a better way to test the Donations API?

Thanks for the help!

Tagged:

Comments

  • Jeff Mills
    Jeff Mills
    Ancient Membership 10 Comments Facilitator Level 3

    I can help with the first 2 parts:

    1. Add value="true" attribute to the opt-in element.
    2. Add an "AddInterest" parameter with the value being a comma-separated list of numerical interest IDs. Normally that is added to Convio URLs as "&AddInterest=####,####" (it's a standard part of URL insertion dialog within WYSIWYG editor), but it should also work as a hidden form parameter.
  • chris 7
    chris 7
    Ancient Membership First Comment Facilitator Level 1
    JeffMills :

    I can help with the first 2 parts:

    1. Add value="true" attribute to the opt-in element.
    2. Add an "AddInterest" parameter with the value being a comma-separated list of numerical interest IDs. Normally that is added to Convio URLs as "&AddInterest=####,####" (it's a standard part of URL insertion dialog within WYSIWYG editor), but it should also work as a hidden form parameter.

    Thanks, Jeff! Those both worked great. We're close to finishing the form and there are only a few small hurdles left. We're having trouble getting level_autorepeat to function correctly. I'll peruse the forums a little more and start a new thread if we need some help.

    Cheers!

  • Steve Mook
    Steve Mook
    Ancient Membership 100 Comments Photogenic Name Dropper
    chris :

    Thanks, Jeff! Those both worked great. We're close to finishing the form and there are only a few small hurdles left. We're having trouble getting level_autorepeat to function correctly. I'll peruse the forums a little more and start a new thread if we need some help.

    Cheers!

    If level_autorepeat=true you must also specify either (sustaining.frequency and sustaining.duration) or ( installment.frequency and installment.duration). Note if you use a checkbox or radio button to set level_autorepeat, you must specify value="true" in the HTML control, otherwise the control will return "on" for the checked condition. The API does not interpret on as true.

    Updated: level_autorepeat is only meaningful if the Form backing the donations API (identified by the form_id parameter) is configured with a Standard Donation Level that has a defined Optional Repeat behavior. To check this, select the Form, select Design Donation Screens, next to Donation Form click Edit. Optional Repeat behavior attributes appear under the Standard Donation Level component.

Categories