Announcement

Collapse
No announcement yet.

CardHolder.BillingAddress format?

Collapse
X
 
  • Filter
  • Time
  • Show
Clear All
new posts

  • CardHolder.BillingAddress format?

    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.

  • #2
    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
    Regards,
    Click & Pledge Support Department

    On Salesforce? Help us by rating our app: Click & Pledge Donor Management on AppExchange

    Join us @ the educational webinars: https://clickandpledge.com/webinars/
    Live Support available Join between 3:00 - 3:30 p.m. ET Monday - Thursday: https://clickandpledge.com/webinars/
    Are you on Salesforce? Join us at the Power of Us Hub: https://powerofus.force.com/0F980000000CjpC

    Comment


    • #3
      Originally posted by documentation
      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.


      Originally posted by Support.Department View Post
      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.
      Last edited by dunsel; 06-25-2009, 09:06 AM.

      Comment


      • #4
        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.
        Regards,
        Click & Pledge Support Department

        On Salesforce? Help us by rating our app: Click & Pledge Donor Management on AppExchange

        Join us @ the educational webinars: https://clickandpledge.com/webinars/
        Live Support available Join between 3:00 - 3:30 p.m. ET Monday - Thursday: https://clickandpledge.com/webinars/
        Are you on Salesforce? Join us at the Power of Us Hub: https://powerofus.force.com/0F980000000CjpC

        Comment


        • #5
          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.

          Comment


          • #6
            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
            Regards,
            Click & Pledge Support Department

            On Salesforce? Help us by rating our app: Click & Pledge Donor Management on AppExchange

            Join us @ the educational webinars: https://clickandpledge.com/webinars/
            Live Support available Join between 3:00 - 3:30 p.m. ET Monday - Thursday: https://clickandpledge.com/webinars/
            Are you on Salesforce? Join us at the Power of Us Hub: https://powerofus.force.com/0F980000000CjpC

            Comment


            • #7
              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.

              Comment


              • #8
                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
                Regards,
                Click & Pledge Support Department

                On Salesforce? Help us by rating our app: Click & Pledge Donor Management on AppExchange

                Join us @ the educational webinars: https://clickandpledge.com/webinars/
                Live Support available Join between 3:00 - 3:30 p.m. ET Monday - Thursday: https://clickandpledge.com/webinars/
                Are you on Salesforce? Join us at the Power of Us Hub: https://powerofus.force.com/0F980000000CjpC

                Comment


                • #9
                  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.
                  Regards,
                  Click & Pledge Support Department

                  On Salesforce? Help us by rating our app: Click & Pledge Donor Management on AppExchange

                  Join us @ the educational webinars: https://clickandpledge.com/webinars/
                  Live Support available Join between 3:00 - 3:30 p.m. ET Monday - Thursday: https://clickandpledge.com/webinars/
                  Are you on Salesforce? Join us at the Power of Us Hub: https://powerofus.force.com/0F980000000CjpC

                  Comment


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

                    Originally posted by xml
                    <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>

                    Comment


                    • #11
                      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
                      Regards,
                      Click & Pledge Support Department

                      On Salesforce? Help us by rating our app: Click & Pledge Donor Management on AppExchange

                      Join us @ the educational webinars: https://clickandpledge.com/webinars/
                      Live Support available Join between 3:00 - 3:30 p.m. ET Monday - Thursday: https://clickandpledge.com/webinars/
                      Are you on Salesforce? Join us at the Power of Us Hub: https://powerofus.force.com/0F980000000CjpC

                      Comment


                      • #12
                        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
                        Regards,
                        Click & Pledge Support Department

                        On Salesforce? Help us by rating our app: Click & Pledge Donor Management on AppExchange

                        Join us @ the educational webinars: https://clickandpledge.com/webinars/
                        Live Support available Join between 3:00 - 3:30 p.m. ET Monday - Thursday: https://clickandpledge.com/webinars/
                        Are you on Salesforce? Join us at the Power of Us Hub: https://powerofus.force.com/0F980000000CjpC

                        Comment

                        Working...
                        X