updateRecurringCreditCardInfo API Questions
Options
Hi,
We just happened to be testing / playing around with the updateRecurringCreditCardInfo API and have the following questions as result of our testing.
The first one, when attempting to update the credit card payment I got the following error code 612001 and would like to reconfirm whether does this means that we could only update an active and ongoing recurring gift and not the "COMPLETED" or "CANCELLED" ones ? (as we are currently under the impression that updating the associated cc used for the latter would actually reactivate the recurring gift, but pardon me if it is not).
The second one, this is more of security best practice purpose. Aside of having the pagebuilder as a secure page and not proxying that, if we use "password" type text input within the form for the Credit Card related fields (i.e. number, cvv) will the API pass it just fine to the backend for processing? or is there any common best practices that we might probably be missing out thus would like to know.
Thanks in advance for your help and time!
regards,
Daniel
We just happened to be testing / playing around with the updateRecurringCreditCardInfo API and have the following questions as result of our testing.
The first one, when attempting to update the credit card payment I got the following error code 612001 and would like to reconfirm whether does this means that we could only update an active and ongoing recurring gift and not the "COMPLETED" or "CANCELLED" ones ? (as we are currently under the impression that updating the associated cc used for the latter would actually reactivate the recurring gift, but pardon me if it is not).
The second one, this is more of security best practice purpose. Aside of having the pagebuilder as a secure page and not proxying that, if we use "password" type text input within the form for the Credit Card related fields (i.e. number, cvv) will the API pass it just fine to the backend for processing? or is there any common best practices that we might probably be missing out thus would like to know.
Thanks in advance for your help and time!
regards,
Daniel
Tagged:
0
Comments
-
Error code 612001 translates to "No recurring gift found" according to the error codes page:
http://open.convio.com/api/#main.error_codes.html
Most likely, this does mean that constituents (donors) cannot update a "COMPLETED" or "CANCELLED" recurring gift, but only active/ongoing recurring gifts. If you run into a situation where a constituent would want to update a completed/cancelled recurring gift, the easiest solution is to direct the constituent to a donation form, where they can make a new recurring gift with the appropriate updated information.
You might verify a few things to confirm this issue:
1) Does the recurring_gift_id you are sending in the "updateRecurringCreditCardInfo" call match a recurring_gift_id returned by a "getRecurringGifts" call?
2) Are you submitting the "updateRecurringCreditCardInfo" with an authentication token identifying the logged-in user that made the original donation, or with valid API administrator credentials (for Server API calls) and passing the cons_id of the user that made the original donation?
For the second question, the "password" input type is only different from the "text" input type in the display to the user in their browser - the "password" input type automatically masks the characters typed by the user with asterisks or circles, while the "text" input type shows the user what they have typed. However, the value entered by the user is still accessed the same way by JavaScript, so your form submission should treat a "password" input type exactly as it would treat a "text" input type.
For example, if I have the following two fields on a form:
<input type="text" id="my_text_field">
<input type="password" id="my_password_field">
These will appear as two text input fields, with the difference that the user will see asterisks or circles when they type in the second field, rather than the text that they typed (which they would see in the first field). JavaScript, however, can access the values typed by the user in each of these fields directly. So, if I typed "12345" in each of the fields shown in my example above, I would expect to see "12345" as the "value" property of those fields in JavaScript, such as:
<script type="text/javascript">
var textValue = document.getElementById('my_text_field').value;
var passValue = document.getElementById('my_password_field').value;
if (textValue == passValue) console.log("All values are the same");
</script>
You can also see this with jQuery, or by using Web Developer tools in your browser to inspect the "POST" arguments sent in your API call. In general, any POST form submission will send the value typed by the user into a "password" input field, just as it does for "text" input fields.
I hope that helps!0 -
Thanks Stephen for the clarification !
As for the additional verification questions you have
You might verify a few things to confirm this issue:
1) Does the recurring_gift_id you are sending in the "updateRecurringCreditCardInfo" call match a recurring_gift_id returned by a "getRecurringGifts" call? Yes, they are. We were mimicking the out-of-the-box functionality that is currently on that default Service Center within "site/UserCenter" that basically list the all the gifts through "getRecurringGifts" API and were giving option to update their credit cards when applicable (if that particular gift transaction was done through CC), thus the id was passed from the previous API on that gift detail ("getRecurringGiftDetails" API) -- We'll have to revise ours then to only give option to update CC when the gift is active/ongoing.
p.s.May I know what is the value of the returned "status" for these ongoing/active gifts?
2) Are you submitting the "updateRecurringCreditCardInfo" with an authentication token identifying the logged-in user that made the original donation, or with valid API administrator credentials (for Server API calls) and passing the cons_id of the user that made the original donation?
I am currently using LuminateExtend library thus defining the auth through it (requiresAuth: true) and checking whether one is logged in or not instead of the API administrator credentials.
thanks again Stephen!
regards,
Daniel0
Categories
- All Categories
- Shannon parent
- shannon 2
- shannon 1
- 21 Advocacy DC Users Group
- 14 BBCRM PAG Discussions
- 89 High Education Program Advisory Group (HE PAG)
- 28 Luminate CRM DC Users Group
- 8 DC Luminate CRM Users Group
- Luminate PAG
- 5.9K Blackbaud Altru®
- 58 Blackbaud Award Management™ and Blackbaud Stewardship Management™
- 409 bbcon®
- 2.1K Blackbaud CRM™ and Blackbaud Internet Solutions™
- donorCentrics®
- 1.1K Blackbaud eTapestry®
- 2.8K Blackbaud Financial Edge NXT®
- 1.1K Blackbaud Grantmaking™
- 527 Education Management Solutions for Higher Education
- 1 JustGiving® from Blackbaud®
- 4.6K Education Management Solutions for K-12 Schools
- Blackbaud Luminate Online & Blackbaud TeamRaiser
- 16.4K Blackbaud Raiser's Edge NXT®
- 4.1K SKY Developer
- 547 ResearchPoint™
- 151 Blackbaud Tuition Management™
- 61 everydayhero
- 3 Campaign Ideas
- 58 General Discussion
- 115 Blackbaud ID
- 87 K-12 Blackbaud ID
- 6 Admin Console
- 949 Organizational Best Practices
- 353 The Tap (Just for Fun)
- 235 Blackbaud Community Feedback Forum
- 55 Admissions Event Management EAP
- 18 MobilePay Terminal + BBID Canada EAP
- 36 EAP for New Email Campaigns Experience in Blackbaud Luminate Online®
- 109 EAP for 360 Student Profile in Blackbaud Student Information System
- 41 EAP for Assessment Builder in Blackbaud Learning Management System™
- 9 Technical Preview for SKY API for Blackbaud CRM™ and Blackbaud Altru®
- 55 Community Advisory Group
- 46 Blackbaud Community Ideas
- 26 Blackbaud Community Challenges
- 7 Security Testing Forum
- 3 Blackbaud Staff Discussions
- 1 Blackbaud Partners Discussions
- 1 Blackbaud Giving Search™
- 35 EAP Student Assignment Details and Assignment Center
- 39 EAP Core - Roles and Tasks
- 59 Blackbaud Community All-Stars Discussions
- 20 Blackbaud Raiser's Edge NXT® Online Giving EAP
- Diocesan Blackbaud Raiser’s Edge NXT® User’s Group
- 2 Blackbaud Consultant’s Community
- 43 End of Term Grade Entry EAP
- 92 EAP for Query in Blackbaud Raiser's Edge NXT®
- 38 Standard Reports for Blackbaud Raiser's Edge NXT® EAP
- 12 Payments Assistant for Blackbaud Financial Edge NXT® EAP
- 6 Ask an All Star (Austen Brown)
- 8 Ask an All-Star Alex Wong (Blackbaud Raiser's Edge NXT®)
- 1 Ask an All-Star Alex Wong (Blackbaud Financial Edge NXT®)
- 6 Ask an All-Star (Christine Robertson)
- 21 Ask an Expert (Anthony Gallo)
- Blackbaud Francophone Group
- 22 Ask an Expert (David Springer)
- 4 Raiser's Edge NXT PowerUp Challenge #1 (Query)
- 6 Ask an All-Star Sunshine Reinken Watson and Carlene Johnson
- 4 Raiser's Edge NXT PowerUp Challenge: Events
- 14 Ask an All-Star (Elizabeth Johnson)
- 7 Ask an Expert (Stephen Churchill)
- 2025 ARCHIVED FORUM POSTS
- 322 ARCHIVED | Financial Edge® Tips and Tricks
- 164 ARCHIVED | Raiser's Edge® Blog
- 300 ARCHIVED | Raiser's Edge® Blog
- 441 ARCHIVED | Blackbaud Altru® Tips and Tricks
- 66 ARCHIVED | Blackbaud NetCommunity™ Blog
- 211 ARCHIVED | Blackbaud Target Analytics® Tips and Tricks
- 47 Blackbaud CRM Higher Ed Product Advisory Group (HE PAG)
- Luminate CRM DC Users Group
- 225 ARCHIVED | Blackbaud eTapestry® Tips and Tricks
- 1 Blackbaud eTapestry® Know How Blog
- 19 Blackbaud CRM Product Advisory Group (BBCRM PAG)
- 1 Blackbaud K-12 Education Solutions™ Blog
- 280 ARCHIVED | Mixed Community Announcements
- 3 ARCHIVED | Blackbaud Corporations™ & Blackbaud Foundations™ Hosting Status
- 1 npEngage
- 24 ARCHIVED | K-12 Announcements
- 15 ARCHIVED | FIMS Host*Net Hosting Status
- 23 ARCHIVED | Blackbaud Outcomes & Online Applications (IGAM) Hosting Status
- 22 ARCHIVED | Blackbaud DonorCentral Hosting Status
- 14 ARCHIVED | Blackbaud Grantmaking™ UK Hosting Status
- 117 ARCHIVED | Blackbaud CRM™ and Blackbaud Internet Solutions™ Announcements
- 50 Blackbaud NetCommunity™ Blog
- 169 ARCHIVED | Blackbaud Grantmaking™ Tips and Tricks
- Advocacy DC Users Group
- 718 Community News
- Blackbaud Altru® Hosting Status
- 104 ARCHIVED | Member Spotlight
- 145 ARCHIVED | Hosting Blog
- 149 JustGiving® from Blackbaud® Blog
- 97 ARCHIVED | bbcon® Blogs
- 19 ARCHIVED | Blackbaud Luminate CRM™ Announcements
- 161 Luminate Advocacy News
- 187 Organizational Best Practices Blog
- 67 everydayhero Blog
- 52 Blackbaud SKY® Reporting Announcements
- 17 ARCHIVED | Blackbaud SKY® Reporting for K-12 Announcements
- 3 Luminate Online Product Advisory Group (LO PAG)
- 81 ARCHIVED | JustGiving® from Blackbaud® Tips and Tricks
- 1 ARCHIVED | K-12 Conference Blog
- Blackbaud Church Management™ Announcements
- ARCHIVED | Blackbaud Award Management™ and Blackbaud Stewardship Management™ Announcements
- 1 Blackbaud Peer-to-Peer Fundraising™, Powered by JustGiving® Blogs
- 39 Tips, Tricks, and Timesavers!
- 56 Blackbaud Church Management™ Resources
- 154 Blackbaud Church Management™ Announcements
- 1 ARCHIVED | Blackbaud Church Management™ Tips and Tricks
- 11 ARCHIVED | Blackbaud Higher Education Solutions™ Announcements
- 7 ARCHIVED | Blackbaud Guided Fundraising™ Blog
- 2 Blackbaud Fundraiser Performance Management™ Blog
- 9 Foundations Events and Content
- 14 ARCHIVED | Blog Posts
- 2 ARCHIVED | Blackbaud FIMS™ Announcement and Tips
- 59 Blackbaud Partner Announcements
- 10 ARCHIVED | Blackbaud Impact Edge™ EAP Blogs
- 1 Community Help Blogs
- Diocesan Blackbaud Raiser’s Edge NXT® Users' Group
- Blackbaud Consultant’s Community
- Blackbaud Francophone Group
- 1 BLOG ARCHIVE CATEGORY
- Blackbaud Community™ Discussions
- 8.3K Blackbaud Luminate Online® & Blackbaud TeamRaiser® Discussions
- 5.7K Jobs Board