Getting Started with FaaS

[Katie P]

Hello Click&Pledge Crew:

I am making a donation form for my website www.familyservice.us. I referenced your FaaS Form Field Names and added them to my HTML form. You can see my form in process here at www.familyservice.us/donate-test

As I continue, I have some very "beginner" questions:

(1) Receipt Information: WID? What is this and where can I find it?

(2) Service Response: I have created secure pages for authorize, decline and error. (https://www.familyservice.us/donate/authorize... etc). What should information or messages would you recommend I include on those pages?

(3) Reference Response: RefID... I simply pass this as a hidden variable and Click&Pledge will generate the Id number? So my HTML would simply be: <input name="RefID" type="hidden" />

(4) Account Information: Guid? Account Id?

Thank you for any help you can provide. I appreciate your willingness to help out a novice!

-- Katie

[CnP.Support]

Kaite,

Glad to see you are working on the FaaS forms. It is easy- you just need to know a few basics.

http://forums.clickandpledge.com/content.php?127-FaaS

Please visit the above articles - starting with FaaS - all your questions are answered there.

Additional info regarding the questions:

2: I suggest you create 3 pages- authorize, decline, and error. We post the reply from the authorization server in the URL so you may easily read the URL and show the authorization code, decline message or the error code.

3: Reference response: Yes- simply pass that as a hidden field and we will return the same value to you as part of the return URL. The field may not be valuable to you if you are not incorporating the form results in a database. The refID is suited for those programmers that insert a record in their database prior to posting to us. When we return the authorization then they take the refID and lookup the record and update it in the database. If you are not having a database then the refID is not all that needed.

4: AccountID and Guid are all provided in the Account Info > API in the administrative portal.

Please set it up and let us know once you are live. We will test it and make sure it is working. Make sure to set the page as TEST mode so the test card # can be used.

[Katie P]

Q: Setting page as TEST mode?

Hello,

Thanks for those answers. I believe I have integrated everything necessary into my form thanks to your help.

My final question is... how do I set page to TEST mode?

Please set it up and let us know once you are live. We will test it and make sure it is working. Make sure to set the page as TEST mode so the test card # can be used.

FYI: I am using Wordpress and created my HTML form in Wordpress. The current URL is www.familyservice.us/donate-test, but when it goes "live", I will be using www.familyservice.us/donate

Thanks for your continued support!

- Katie

[CnP.Support]

Katie,

your form looks great. You are almost there.

In your form you are missing the form element for OrderMode.

input type="hidden" name="OrderMode" id="OrderMode" value="Test"

See the following example:

https://www.clickandpledge.com/developers/faas/example/002/

the form is also available for download from that link.

The description for the node is at:

https://developers.clickandpledge.com/WordDocuments/formfieldnames.htm

it is the last node described in that page.

Please set it and let me know when it is live or if you have any other issues.

[Katie P]

Hello,

Thanks again for the quick response and help. I have added the form element for Order Mode. Ready to test!

--- Katie

[CnP.Support]

Katie,

I just reviewed your form. Please note that the API requires State & Country in the form of country code and state abbreviation. See the example.

you need to add State & Country as pull down menu similar to what we have in the example. We have provided State & Country lists so you can use it as an include and not worry about it. See the manual:

https://developers.clickandpledge.com/WordDocuments/samplesdownloads.htm

there are 2 files for country & state that may be used as includes.

[Katie P]

Hello again,

Thanks for reviewing my form. Could you possibly be help me with the "includes" coding you mentioned? I am using Wordpress, so I am limited to HTML code and cannot use PHP...

-- Katie

[Katie P]

Answered my own question! Ready for new review!

Please disregard my last message. I answered my own question after some more thought and work...

Hello again,

Thanks for reviewing my form. Could you possibly be help me with the "includes" coding you mentioned? I am using Wordpress, so I am limited to HTML code and cannot use PHP...

-- Katie

I am ready for my form to be re-reviewed and tested. Thanks for your continued help, I very much appreciate it.

[CnP.Support]

Katie,

It almost worked. I see the following when I do a transaction:

https://www.familyservice.us/donate/error/?err=Error%20:%20URL%20restriction%20violation&RefID=

Error is: URL restriction

In your URL restriction site you have listed:

https://www.familyservice.us

Please note that the system asks for the domain so you have to list: www.familyservice.us

you should not add https://

please remove it and test it -- use the dummy card:

4111111111111111 (4 and 15 - 1's)
expiration any date in future
cv2: 123

we can test it again if you want but please fix the restriction first. I did not change it for you since I wanted you to see what you in there.

[Katie P]

Hello again,

Thanks for your reply. I changed the URL restriction site and ran another test. I am now getting the following error:

https://www.familyservice.us/donate/...20empty&RefID=

Any ideas?

Thanks for your continued assistance!

- Katie

[CnP.Support]

Missing parameters

Basket is empty means the name of the basket is not being passed.

The following are required:

<input type="radio" name="UnitPrice" id="UnitPrice" value="30" />
<input name="ItemID" type="hidden" id="ItemID" value="3" />
<input name="ItemName" type="hidden" id="ItemName" value="Donation" />
<input name="Quantity" type="hidden" id="Quantity" value="1" />
<input name="UnitDedutiblePercentage" type="hidden" id="UnitDedutiblePercentage" value="100" />

I see that you have the ItemName and UnitPrice but are missing the Quantity, UnitDeductiblePercentage, and ItemID

Unless I add those in a test environment and test it I won't be able to say if that is the only problem. For now those are missing.

I will spend a little more time and copy your code to our test environment and test it. Can you make the additions and then test?

[Katie P]

I made the additions... now the error reads: https://www.familyservice.us/donate/...0value.&RefID=

I actually did not include "BillingPhone" in my form. I am going to add it and give it a try... 5 minutes later... okay that worked! Now the only little hitch is that the successfully submitted form did not redirect me to my Authorization page. Instead, it brought me to: https://www.familyservice.us/donate-...111&vg=&RefID=

In my code, I have: <input name="OnSuccessfulURL" id="OnSuccessfulURL" type="hidden" value="https://www.familyservice.us/donate/authorize" />

So after successful submission, it should go to www.familyservice.us/donate/authorize... right? Wonder why its not going there.

Katie

[CnP.Support]

Katie,

If an error occurs it will post back to your error page. It is doing it correctly since you have an ERROR and the link it posts to is your ERROR page.

Once all error is taken care of then it will post to the Authorize page.

[Katie P]

Redirection to confirmation page...

I think I should clarify... the dummy credit card payment passes okay. I even receive an email addressed to the pretend donor stating that the donation was made.

However, within the website, after hitting 'submit', I would like donors to be redirected to a page or message confirming that the transaction was successful. As it stands, donors are just redirected to: https://www.familyservice.us/donate-...111&vg=&RefID=

Katie,

If an error occurs it will post back to your error page. It is doing it correctly since you have an ERROR and the link it posts to is your ERROR page.

Once all error is taken care of then it will post to the Authorize page.

[CnP.Support]

Katie,

In your program you have the following:

<input name="OnSuccessfulURL" id="OnSuccessfulURL" type="hidden" value="https://www.familyservice.us/donate/authorize" />
<input name="OnDeclineURL" id="OnDeclineURL" type="hidden" value="https://www.familyservice.us/donate/decline" />
<input name="OnErrorURL" id="OnErrorURL" type="hidden" value="https://www.familyservice.us/donate/error" />

Naturally if computers were intelligent enough to know intent rather than code world would be different

The right syntax for successful URL is: OnSuccessUrl and NOT OnSuccessfulURL

You should change the line dealing with success to:

<input name="OnSuccessURL" id="OnSuccessURL" type="hidden" value="https://www.familyservice.us/donate/authorize" />

try it and let us know.