CardHolder.BillingAddress format?

[dunsel]

In the API documentation https://developers.clickandpledge.com/

CnPAPI.Engine.Request.Order.CardHolder is missing the details for BillingAddress.

This is important to me because I am getting "Internal error occured" when attempting to submit payment using some billing addresses. I suspect I am not providing the correct BillingStateProvince, or possibly an incorrect BillingCountryCode.

[CnP.Support]

Billing address

Hi;

I am not sure what you mean by billing address is missing. It is described in the manual .. please see the following link:

https://developers.clickandpledge.co...cardholder.htm

Have you downloaded the sample XML? we also have samples in PHP and Flash that you can review.

You should also use our sandbox for testing of your XML. The sandbox link is provided in the developers area.

Regards,
The Support Department

[dunsel]

CardHolder

Path: CnPAPI.Engine.Request.Order. CardHolder

Elements:

• BillingInformation
• BillingAddress
• ShippingInformation
• CustomFieldList
• PaymentMethod

More:

BillingInformation
ShippingInformation
CustomFieldList
PaymentMethod

As I said in my first post, that link has other information relating to the CardHolder information but does not have the BillingAddress specifications. I've gotten as far as I have following what the ShippingAddress would need as an estimation for BillingAddress but I have encountered problems that may be due to different requirements.

For some examples of questions the documentation should answer:
Does the BillingAddress require a state? If so, what is the name of this field?
Is the state represented as a string or an integer? What is the length of this field?
Is there a BillingPostalCode field? If so, is it required? If so, what format does it accept?

I believe I have answered these for myself through trial-and-error but the BillingAddress specifications should really be in the documentation. I have already answered these to my own satisfaction but there are similar pieces of information (too many to ask individually) missing from the documentation that I would like to see.

Also, CnPAPI.Engine.Request.Order.CardHolder.BillingInfo rmation.BillingEmail is specified as not required but whenever it is omitted I receive an error. I suspect it should be shown as required in the documentation.

I am not sure what you mean by billing address is missing. It is described in the manual .. please see the following link:

https://developers.clickandpledge.co...cardholder.htm

EDIT: I now see the information I was seeking, it is not where it should be. CardHolder lists BillingAddress but does not specify it. The specification is under CardHolder.BillingInformation.BillingAddress. I believe this is an error, your example XML shows BillingAddress contained inside of CardHolder, not BillingInformation.

[CnP.Support]

API information

Hi;

Are you referring to the online manual?

It is explained in great detail. Here is what we have on state:

https://developers.clickandpledge.co...teprovince.htm

we have a lot of developers that have developed based on this API and we have only heard of how easy it is to set it up.

the manual shows:

Range Minimum: 2 characters
Maximum: 50 characters


it has example:


<BillingStateProvince>Virginia</BillingStateProvince>

It also states:

Required: Yes

That is why I am confused about your question.


Please let me know what page in the manual you are seeing lack of information and we will gladly add it.


Regards,
The Support Department.

[dunsel]

Clicking on your link:
https://developers.clickandpledge.co...cardholder.htm

Goes to this location:
https://developers.clickandpledge.co...cardholder.htm

Which is missing the link for BillingAddress.

As I stated previously I have already answered my question, however if the documentation was linked correctly it would have taken minutes rather than hours.

[CnP.Support]

Billing information

Hi;

Click on the BillingInformation link provided below. It will then show you the details of the the node which includes BillingAddress.

See the links below the page which takes you to sub-headings of the section.

Regards,
The Support Department

[dunsel]

Thanks for your help, I do appreciate the quality support I've received from Click&Pledge and this API is excellent in what it can do. This is something I've been looking for for about 6 years now.

If you can please update CardHolder to contain the link to BillingAddress. It is currently placed in BillingInformation, which is not correct.

[CnP.Support]

BillingAddress

Hi;

I noticed that in the manual we had BillingAddress listed in the bulleted list of sections covered. That description does not belong there and is part of the BillingInformation.

Thanks for lettings us know- we removed it from that section.

The manual is complete and if you go to the BillingInformation you will see details there.

Let us know if we can be of any further assistance.

Regards,
The Support Department

[CnP.Support]

BillingAddress location

Hi;

Thanks for the info.

I see the confusion..

I will review the manual and see what is going on. We will fix it immediately if there is a problem.

Regards,
The Support Department.

[dunsel]

That is odd, in the example XML it is a member of CardHolder, not BillingInformation.

<CardHolder>
<BillingInformation>
<BillingFirstName>John</BillingFirstName>
<BillingMI>C</BillingMI>
<BillingLastName>Smith</BillingLastName>
<BillingEmail>[email protected]</BillingEmail>
<BillingPhone>123.456.7890</BillingPhone>
</BillingInformation>
<BillingAddress>
<BillingAddress1>Post Office Box 1000</BillingAddress1>
<BillingAddress2 />
<BillingAddress3 />
<BillingCity>Blacksburg</BillingCity>
<BillingStateProvince>VA</BillingStateProvince>
<BillingPostalCode>12346-4563</BillingPostalCode>
<BillingCountryCode>840</BillingCountryCode>
</BillingAddress>

[CnP.Support]

Fixed BillingAddress

Hi;

I figured out what the problem was. Thanks for pointing it to us. I wonder why other developers did not bring this to our attention.

The BillingAddress was set to a wrong heading and therefore it was listed in the wrong order.

It is fixed now.. we will update the PDF shortly. The site is updated.

Please review it and let us know if the fix is what you were having an issue with.

Regards,
The Support Department

[CnP.Support]

Manual: PDF Update

The PDF download for the manual was just updated and uploaded to the site.

The PDF manual now shows the fixed BillingAddress node location within the chain.

Thanks for pointing it out.

Regards,
The Support Department