Donations API Error XML Documentation

As it turns out, there is no complete documentation on the xml structure of the errors returned by the Donation API. As a result, I've been encouraged to start posting the errors that I have seen. If you are also using the donation API, please post different types of error messages that you have seen. Here are a few to start it off.

Note: The main difference I can see is when it's a credit card number related error. Also, the field validations seem to be performed first. If you have field validation errors and a bad credit card number, it will only report the field errors. It also seems that the regex for credit card number length and the check for the expiration date being in the past seem to be handled by the field validation mechanism instead of the credit card processing mechanism.

Field Errors

<donationResponse xsi:schemaLocation="http://convio.com/crm/v1.0 http://service.convio.net/xmlschema/crm.public.v1.xsd">

<errors>

<code>101</code>

<message>

Error: There was a problem encountered while processing your donation.

</message>

<reason>FIELD_VALIDATION</reason>

<pageError>

There was a problem processing your request. Please see below.

</pageError>

<fieldError>Credit card number is invalid.</fieldError>

<fieldError>Gift amount is invalid.</fieldError>

<fieldError>Billing city is required.</fieldError>

</errors>

</donationResponse>

Malformed Credit Card Number (too few digits etc)

<donationResponse xsi:schemaLocation="http://convio.com/crm/v1.0 http://service.convio.net/xmlschema/crm.public.v1.xsd">

<errors>

<code>101</code>

<message>

Error: There was a problem encountered while processing your donation.

</message>

<reason>FIELD_VALIDATION</reason>

<pageError>

There was a problem processing your request. Please see below.

</pageError>

<fieldError>Credit card number is invalid.</fieldError>

</errors>

</donationResponse>

Expiration Date Is Past

<donationResponse xsi:schemaLocation="http://convio.com/crm/v1.0 http://service.convio.net/xmlschema/crm.public.v1.xsd">

<errors>

<code>101</code>

<message>

Error: There was a problem encountered while processing your donation.

</message>

<reason>FIELD_VALIDATION</reason>

<pageError>

There was a problem processing your request. Please see below.

</pageError>

<fieldError>Credit card expiration date is invalid.</fieldError>

</errors>

</donationResponse>

Bad Credit Card/CVV Number

<donationResponse xsi:schemaLocation="http://convio.com/crm/v1.0 http://service.convio.net/xmlschema/crm.public.v1.xsd">

<errors>

<code>101</code>

<message>

Error: There was a problem encountered while processing your donation.

</message>

<reason>CARD_DECLINED</reason>

<declineReason>CARD_DECLINE</declineReason>

<declineDetail>Invalid account number: INVALID CARD</declineDetail>

<declineUserMessage>

The credit card was declined. Please check the information that you entered.

</declineUserMessage>

<pageError>

The credit card was declined. Please check the information that you entered.

</pageError>

</errors>

</donationResponse>