{GlobalGiving API} New features/changes to the API released today, 4/17/10

[Steve R.]

Please see updated documentation at http://www.globalgiving.org/to-go/

The changes released today include:

* An extra element, <currencyCode> is returned with all Donation and
Invoice responses, Primarily this will always be USD (for US
dollars), as Globalgiving only processes donations in USD. See
http://www.globalgiving.org/to-go/submit-a-donation.html

* An optional element (related to above) is available on the Donation
and Order request is the <currencyCode> element. If you make no
changes, your api calls will continue to work fine, as this will
default to USD. We have added this element to handle extensions for
the globalgiving UK (http://www.globalgiving.co.uk) which can use the
same API, but will require a special api key, and you must specify the
<currencyCode> of GBP in Donation and Order requests. Please contact
us here: http://www.globalgiving.org/contactus/

* There is a new *optional* element on the <error> element (http://
www.globalgiving.org/to-go/api-conventions.html). This field, called
<error_number> will only (currently) be applicable to Donation
requests that return a status code of other than 200. The
error_number will relate to the type of error encountered while
processing the credit card payment. If the <error_number> is present,
it relates to the result code returned from Paypal's Payflow Gateway
product (which GlobalGiving uses to process payments). The manual can
be found here: https://cms.paypal.com/cms_content/US/en_US/files/developer/PP_PayflowPro_Guide.pdf.
The Paypal developer site for Payflow Pro is here:
https://www.x.com/community/ppx/payflow_pro. GlobalGiving does
limited customization based on the result code, but if a developer
chooses to provide finer grained message handling, the "error_number"
can be used. The warning is that since this is Paypal's product, it
is subject to change, and GlobalGiving is not responsible for alerting
you if the <error_number> changes in meaning.

Please post any questions or suggestions to this list!
Steve

--
You received this message because you are subscribed to the Google Groups "GlobalGiving API" group.
To post to this group, send email to globalgi...@googlegroups.com.
To unsubscribe from this group, send email to globalgiving-a...@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/globalgiving-api?hl=en.