Return user entered values from the donate API

Ryan Hagg

Is there a way to get the name a donor puts down as 'Name on Card' in the API back to me?

Noah Cooper

Hey Ryan,

Where are you trying to return the value exactly? On the thank you page, for example?

Ryan Hagg

Noah Cooper:

Hey Ryan,

Where are you trying to return the value exactly? On the thank you page, for example?

Yes, being able to throw it in the URL of success or error would be fine. We need to know the name on card in this instance as that is the primary donor. I would also like to be able to track errors so we can follow up with some donors to see if they would prefer to send a check or some other method. Not sure how else to get information besides the URL when the api is embedded in an iframe.

Thanks.

Ryan Hagg

Ryan Hagg:

Yes, being able to throw it in the URL of success or error would be fine. We need to know the name on card in this instance as that is the primary donor. I would also like to be able to track errors so we can follow up with some donors to see if they would prefer to send a check or some other method. Not sure how else to get information besides the URL when the api is embedded in an iframe.

Thanks.

So it turns out we're actually going to need a bit more functionality. We just sent our site through a security audit and the auditor/white hat hacker said that we will need a bit more for the Convio piece.

We are using the API only to charge credit cards. All the cart action is being done outside of Convio. When the cart has $1000 worth of gifts in it and then we send to convio we need to be sure that the card was charged successfully for $1000 and if not, what went wrong. We'll need name on card, address, amount charged and success code all returned to us in an encrypted format so we can unencrypt and validate. Is that doable?

Thanks.

Steve Mook

Ryan Hagg:

So it turns out we're actually going to need a bit more functionality. We just sent our site through a security audit and the auditor/white hat hacker said that we will need a bit more for the Convio piece.

We are using the API only to charge credit cards. All the cart action is being done outside of Convio. When the cart has $1000 worth of gifts in it and then we send to convio we need to be sure that the card was charged successfully for $1000 and if not, what went wrong. We'll need name on card, address, amount charged and success code all returned to us in an encrypted format so we can unencrypt and validate. Is that doable?

Thanks.

The API call will return a success or error response that includes the billing name, amount, and confirmation code (or, in the case of an error, the error information) as XML or JSON. You can either parse and process this information in your client-side script, or redirect to another URL; for example:

success_redirect=https://my.url.org/myproc?confirmation_code=${donationResponse/donation/confirmation_code}

&id=${donationResponse/donation/transaction_id}

&amount=${donationResponse/donation/amount/decimal}

&timestamp=${donationResponse/donation/date_time}

Currently it does not appear possible to return name information through redirect parameters, i.e. the following XPath constructs are not supported:

&f_name=${donationResponse/donation/summary_data/field//value}

&l_name=${donationResponse/donation/summary_data/field//value}

Another option might be to define a notification email address for donations through the API form.